{"id":15679265,"url":"https://github.com/shekohex/coemu","last_synced_at":"2025-05-07T10:14:45.138Z","repository":{"id":89445053,"uuid":"289749986","full_name":"shekohex/coemu","owner":"shekohex","description":"Conquer Online 2.0 Server Emulator","archived":false,"fork":false,"pushed_at":"2025-03-07T17:13:55.000Z","size":877,"stargazers_count":19,"open_issues_count":8,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-05-07T10:14:33.475Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shekohex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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,"zenodo":null}},"created_at":"2020-08-23T19:05:56.000Z","updated_at":"2025-02-17T13:18:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"7f218edc-a123-4624-a202-d54ee944524e","html_url":"https://github.com/shekohex/coemu","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shekohex%2Fcoemu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shekohex%2Fcoemu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shekohex%2Fcoemu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shekohex%2Fcoemu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shekohex","download_url":"https://codeload.github.com/shekohex/coemu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252856558,"owners_count":21814858,"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-10-03T16:27:57.311Z","updated_at":"2025-05-07T10:14:45.103Z","avatar_url":"https://github.com/shekohex.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch2 align=\"center\"\u003eCoEmu (COServer Emulator)\u003c/h2\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003e\n        Fully Featured Conquer Online 5017 Server Emulator\n  \u003c/strong\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003e\n      ⚠ Still Under Constructions ⚠.\n  \u003c/sub\u003e\n\u003c/div\u003e\n\n## About\n\nCoEmu is a Conquer Online server project containing an account server and game server. The account server authenticates players, while the game server services players in the game world. This simple two-server architecture acts as a good introduction into server programming and networking. The server is interoperable with the Conquer Online game client, patch 5017 (not provided by this project).\n\n## Build and Run\n\n1. [Install Rust](https://rustup.rs/)\n\n2. Use Nightly Rust (it offers speed compile-time).\n\n```bash\nrustup default nightly\n```\n\n3. Clone and Configure\n\n```bash\ngit clone https://github.com/shekohex/coemu \u0026\u0026 cd coemu \u0026\u0026 cp .env.example .env # edit the env file if you want.\n```\n\n4. Start Database\n\nWe are using [Sqlite](https://sqlite.org/) as Database for storing all of server data and states.\n\nTo make things easy, Install [sqlx-cli](https://github.com/launchbadge/sqlx/tree/master/sqlx-cli) for running Database Migrations.\n\n```bash\n$ cargo install sqlx-cli --no-default-features --features rustls,sqlite\n```\n\nthat will take some time, then run\n\n```bash\nsqlx migrate run --database-url 'sqlite://data/coemu.db?mode=rwc'\n```\n\nGood, let's build the servers!\n\n5. Build and Run Server\n\nNow After the database is ready, run the servers\n\n- **Auth Server**\n\n```bash\n$ cargo auth\n```\n\n- **Game Server**\n\n```bash\n$ cargo game\n```\n\n## Game Client Download\n\n\u003e Note: This Game is only available for Microsoft Windows OS.\n\u003e So if you willing to use it on Mac or Linux, I highly recommend looking at https://www.playonlinux.com/en/ or use a Windows VM.\n\nThis Server Emulator is build for Conquer Online version 5017. you can download this version from [here](https://mega.nz/folder/xJQnlSRD#d4oLOGq2LNbKm_k8kYVKJw/file/dMx3jDoC).\n\n## Documentations\n\nCurrently We try to Write Every Single Detail about anything in the codebase it self, so at the end we have a self-documanted codebase.\nall you have to do to view docs, Run:\n\n```\n$ cargo doc --no-deps --document-private-items --open\n```\n\n## FAQ\n\n1. How do I configure the client?\n\n- You may connect to your server instance without modifying client code. Create a shortcut to Conquer.exe and add \"blacknull\" as a target command-line argument. Open server.dat and enter the following (adding your IP address). Be sure not to specify an internal IP address (must be external or a loopback adapter). If you specify an internal IP address, the client will throw an error: \"Server.dat is damaged\".\n\n```ini\n[Header]\nGroupAmount=1\nGroup1=GroupPic4\n\n[Group1]\nServerAmount=1\n\nServer1=CoEmu\nIp1=\nPort1=9958\nServerName1=CoEmu\nHintWord1=\nPic1=servericon33\n\n```\n\n2. How do I create an account?\n\nTo Create an Account, you should open the Database on a Database Manager (something like [Datagrip](https://www.jetbrains.com/datagrip/) or [alternatives](https://www.slant.co/options/210/alternatives/~datagrip-alternatives)) then in the `accounts` table you should create a new raw with your account information, you should only need to input the `username` and `password`.\nPlease note that the `password` needs to be hashed using [Bcrypt](https://en.wikipedia.org/wiki/Bcrypt) .. You could use the provided tool to get a hashed password, just run\n\n```bash\n$ cargo hash-pwd \u003cpassword\u003e\n```\n\nfor example\n\n```\n$ cargo hash-pwd test\n$2b$12$iSrnkacd/i/8eZr5pBoDlO5qcbLmLUWGQ6IN.oQuemnlRKU/NExIW\n```\n\nAfter creating the account, you should be able to login and create your character :)\n\n## Resources\n\n- [Epvp](https://elitepvpers.com/forum/co2-private-server)\n- [ConquerWiki](https://www.conquerwiki.com/doku.php?id=start)\n- [Comet](https://gitlab.com/spirited/comet)\n\n## Contributing\n\nWant to join us? Check out our [\"Contributing\" guide][contributing] and take a\nlook at some of these issues:\n\n- [Issues labeled \"good first issue\"][good-first-issue]\n- [Issues labeled \"help wanted\"][help-wanted]\n\n[contributing]: .github/CONTRIBUTING.md\n[good-first-issue]: https://github.com/shekohex/coemu/labels/good%20first%20issue\n[help-wanted]: https://github.com/shekohex/coemu/labels/help%20wanted\n\n## Legality\n\n\u003csub\u003e\nAlgorithms and packet structuring used by this project for interoperability with the Conquer Online game client is a result of reverse engineering. By Sec. 103(f) of the DMCA (17 U.S.C. § 1201 (f)), legal possession of the Conquer Online client is permitted for this purpose, including circumvention of client protection necessary for archiving interoperability. CoEmu is a non-profit, academic project and not associated with TQ Digital Entertainment. All rights over CoEmu are reserved by Shady Khalifa \"shekohex\". All rights over the game client are reserved by TQ Digital Entertainment.\n\u003c/sub\u003e\n\n## License\n\n\u003csup\u003e\nLicensed under \u003ca href=\"LICENSE\"\u003eGPL v3.0 license\u003c/a\u003e.\n\u003c/sup\u003e\n\n\u003cbr/\u003e\n\n\u003csub\u003e\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in this crate by you, as defined in the GPL-3.0 license, shall\nbe licensed as above, without any additional terms or conditions.\n\u003c/sub\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshekohex%2Fcoemu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshekohex%2Fcoemu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshekohex%2Fcoemu/lists"}