{"id":19614818,"url":"https://github.com/leancloud/multiplayer-server-plugin-getting-started","last_synced_at":"2026-06-09T01:05:25.167Z","repository":{"id":43893151,"uuid":"188335696","full_name":"leancloud/multiplayer-server-plugin-getting-started","owner":"leancloud","description":null,"archived":false,"fork":false,"pushed_at":"2024-05-21T05:25:36.000Z","size":68,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-01-09T10:33:02.630Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leancloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-24T02:04:22.000Z","updated_at":"2021-10-11T10:58:17.000Z","dependencies_parsed_at":"2025-01-10T09:01:48.292Z","dependency_job_id":null,"html_url":"https://github.com/leancloud/multiplayer-server-plugin-getting-started","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leancloud%2Fmultiplayer-server-plugin-getting-started","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leancloud%2Fmultiplayer-server-plugin-getting-started/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leancloud%2Fmultiplayer-server-plugin-getting-started/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leancloud%2Fmultiplayer-server-plugin-getting-started/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leancloud","download_url":"https://codeload.github.com/leancloud/multiplayer-server-plugin-getting-started/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240906847,"owners_count":19876683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T10:53:54.047Z","updated_at":"2026-06-09T01:05:20.137Z","avatar_url":"https://github.com/leancloud.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# multiplayer server plugin getting started\n\n## 测试服务器使用说明\n\n测试服务器指在本地启动的游戏服务器，用于测试游戏的 Plugin 功能，可以用任意 APP ID 登录，但整个服务最多只能同时登录 20 个客户端。\n\n为了能正常启动，请至少准备 512M 空余内存。需要提前安装 jdk8 以上版本 jdk。\n\n### 启动\n\n1. [在 Releases](https://github.com/leancloud/multiplayer-server-plugin-getting-started/releases) 内找最新一次 Release 记录打开 Assets 下载 game-standalone.tar.gz \n1. 解压 game-standalone.tar.gz 后进入 game-standalone 目录\n1. 执行 game-standalone 目录内 launch.sh 来启动 game 服务\n1. game 服务启动后，launch.sh 会自动展示 game 服务的 STDOUT 输出，不关心其输出时可以 CTRL + C 退出，game 服务会在后台继续运行\n1. 安装 python3 以及配合使用的 pip\n1. 执行 `pip install -r multiplayer-server-plugin-getting-started/testing-tools/requirements.txt` 安装测试依赖\n1. 执行 `multiplayer-server-plugin-getting-started/integration-test-scripts/run-tests.sh` 能正常运行完毕表示 Plugin 部署成功，并成功测试了作为示例的 `master_is_watching_you_plugin`\n\n### 关闭\n\n1. 进入 game-standalone 目录内执行 shutdown.sh 来关闭后台运行的 game 服务\n\n### 重启\n\n1. 进入 game-standalone 目录内执行 restart.sh 来重启后台运行的 game 服务\n\n### 日志\n\ngame 服务在后台运行时产生的日志记录会留在 `game-standlone/logs` 目录内。目前日志名称和用途如下：\n\n文件 | 说明\n---- | ---\ngc-XXX.current | GC 日志\nserver.log | game 服务运行日志\nstdout.log | 进程的 STDOUT 输出\nplugin.log | 用户实现的 plugin 输出的日志\nevent.log | 事件日志，如用户登录登出等\n\n### 启动过程常见错误处理\n\n1. game-standalone 启动后 STDOUT 输出 ”java.net.BindException: Address already in use“\n\n该错误为当前系统运行了多个 game-standalone 服务，请通过查找并杀死系统内已经存在的 game-standalone 进程，再尝试重新启动 game-standalone 服务。\n\n2. 启动 game-standalone 后提示错误 \"service game-standalone is running, please check pid file.\"\n\n请通过系统工具确认是否已经有 game-standalone 进程在系统内运行，如果有请将该进程杀死后重新执行启动 game-standalone 服务。如果没有，请在 game-standalone 目录下找到 proc.pid 文件并将其删除。之后重试启动 game-standalone 服务。\n\n## 示例 Game Plugin 打包与部署\n\n测试游戏服务器已经将最新版本的 multiplayer-server-plugin-getting-started 工程打包，测试游戏服务器启动后会自动加载 multiplayer-server-plugin-getting-started 实现的 Plugin。\n\n在对 multiplayer-server-plugin-getting-started 工程做修改后，想打包新的 Plugin 至测试服务器方法如下：\n\n1. 请先将游戏测试服务器运行起来\n1. 进入修改后的 Plugin 工程，以 multiplayer-server-plugin-getting-started 为例就是进入 multiplayer-server-plugin-getting-started 目录下，执行 `mvn clean package`\n1. 拷贝生成的 `multiplayer-server-plugin-getting-started/target/multiplayer-server-plugin-getting-started-xxx-jar-with-dependencies.jar` 至 `game-standalone/extensions`\n1. 等待几秒后游戏测试服务器会自动加载新的 Plugin\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleancloud%2Fmultiplayer-server-plugin-getting-started","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleancloud%2Fmultiplayer-server-plugin-getting-started","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleancloud%2Fmultiplayer-server-plugin-getting-started/lists"}