Release v0.2.1 (What’s new?).
Welcome to acore_soap Documentation#
azerothcore 魔兽世界服务器 自带一个类似于 Terminal 的交互式 Console. GM 可以在里面输入命令来创建账号, 修改密码, 封禁账号等, 例如 .account create $account $password. 你如果用 GM 账号登录游戏客户端, 你也可以在游戏内聊天框输入 GM 命令, 本质是一样的.
如果你希望像操作 Rest API 一样的远程执行命令, 以上两种方法就不太实用了. 一种你需要 SSH 到服务器上才能接触到 console, 一种你需要登录游戏客户端, 而客户端是没有我们需要的变成接口的. 而这种需求对于服务器维护者来说又是实实在在的. 例如服务器可能有一个官网, 让会员用户可以在网站上点击购买物品后, 游戏服务器就自动运行一条 GM 命令将物品发送到用户游戏角色的邮箱. 在这个例子里 GM 命令的发起端是 Web 服务器, 而运维的时候 GM 命令的发起端可以是任何东西, 例如 VM, Container, Lambda Function 等. 所以我们就需要一套机制能仅让有权限的人或机器远程执行 GM 命令. 这个需求对于长期的正式运营非常重要.
我创造了一整套工具用于实现这个需求. 其中这个 acore_soap 项目是这一整套工具的基石. 在应用层, 它提供了一套 Pythonic 的 API 用参数化的方式发送 GM 命令, 并将返回的信息解析成机器友好的 Python 对象. 在底层, 它提供了一套 SOAPRequest 和 SOAPResponse 的抽象, 实现了发送 command 和获取 response message 的核心逻辑. 你可以用这个基石来构建更高级的应用, 例如一个 Web 服务器, 一个 Discord Bot 等等.
和这个项目相关的其他项目有:
acore_soap_agent: 一个部署在游戏服务器 EC2 上的 CLI 程序, 作为外部程序远程执行 GM 命令的代理.
acore_soap_remote: 一个在除了游戏服务器 EC2 以外的任何地方其他地方远程执行 GM 命令的 SDK.
Install#
acore_soap is released on PyPI, so all you need is to:
$ pip install acore-soap
To upgrade to latest version:
$ pip install --upgrade acore-soap