Unofficial CardLife revival project, pronounced like "celery"
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.md 5.4KB

4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108
  1. # CLre
  2. Always eat your celery, so you'll grow up to be big and strong like me.
  3. Work-in-progress mod for [CardLife](http://cardlifegame.com/).
  4. CardLife has stopped receiving updates, but that doesn't mean it's free from bugs.
  5. CLre is a mod to rejuvenate CardLife by fixing old bugs and adding some modding sprinkles.
  6. ## Setup
  7. This project requires most of Cardlife's `.dll` files to function correctly.
  8. Most, but not all, of these files are stored in Cardlife's `Cardlife_Data\Managed` folder.
  9. The project is pre-configured to look in a folder called cl in the solution's main directory or one level up from that.
  10. You can make sure CLre can find all of `.dll` files it needs by copying your Cardlife folder beside this repo's folder and renaming it to `cl`, but that's a bit of a waste of disk space.
  11. You can also create a symbolic link to your Cardlife install folder named `cl` in the same spot to avoid having to re-copy files.
  12. For example, if you cloned the repo into a folder called `CLre_repo`, this is what your folder structure would look like.
  13. If you decide to change the `cl` folder configuration, do not commit changes to your `CLre.csproj` or `CLre_server.csproj` files otherwise your changes will be rejected.
  14. ```
  15. CLre_repo/ <- CLre git project files
  16. CLre/ <- Code files
  17. README.md <- This file
  18. etc.
  19. cl/ <- CardLife files
  20. Cardlife_Data/
  21. Managed/ <- Cardlife C# Assemblies
  22. CardlifeGameServer_Data/
  23. Managed/ <- Cardlife Server C# Assemblies (optional)
  24. ```
  25. For any game mod to work, you will have to patch your game with the Cardlife adaptation of [CLIPA](https://git.exmods.org/NGnius/CLIPA).
  26. FOr a server mod to work, you will have to patch the server (CardlifeGameServer.exe).
  27. The installation process is roughly the same as for Gamecraft, except with a different name: [GCIPA Gamecraft install guide](https://git.exmods.org/modtainers/GCIPA/src/branch/master/README.md#how-to-install).
  28. ## Building
  29. After you've completed the setup, open the solution file `CLre.sln` in your prefered C# .NET/Mono development environment.
  30. I'd recommend Visual Studio Community Edition or JetBrains Rider.
  31. If you've successfully completed setup, you should be able to build the CLre project without errors.
  32. If it doesn't work and you can't figure out why, ask for help on the [Exmods Discord server](https://discord.exmods.org).
  33. ## Installation
  34. To install the CLre mod, copy the build's `CLre.dll` into the `Plugins` folder where Cardlife is installed.
  35. To install the CLre_server mod, copy the CLre_server build's `CLre_server.dll` into the `Plugins` folder where Cardlife is installed.
  36. ## A Note on CLre and CLre_server mods' (lack of) cooperation
  37. CLre is designed for the Cardlife client, and cannot be used to mod the Cardlife server.
  38. Similarly, CLre_server is designed for the Cardlife server, and cannot be used to mod the Cardlife client.
  39. DO NOT install CLre and CLre_server in the same `Plugins` folder, because both mods will be loaded -- guaranteeing one will break.
  40. To install CLre and CLre_server on the same computer, create a copy of the game installation and use one copy for CLre and one for CLre_server.
  41. # Functionality
  42. ## CLre
  43. CLre provides a minimal modding API and useful bugfixes for the Cardlife client.
  44. ### Fixes
  45. As of v0.0.1, six (6) bugfixes are implemented.
  46. - InitLogSooner: Start the logger slightly sooner than Cardlife does [TARGET: CustomLoggerThread] [ID: 0] (0M/2P/1I/0W/0A/0D/3T)
  47. - EnchantmentTableFloatParseFix: [MORE: https://trello.com/c/qawBFb7P/1-enchantment-table-fails-to-work] [ID: 1] (0M/2P/0I/0W/0A/0D/2T)
  48. - ExclusionImprovement: [MORE: https://trello.com/c/Ue4yIqWQ/11-placing-material-in-restricted-areas] [ID: 2] (0M/2P/0I/0W/0A/0D/2T)
  49. - ClientDurabilityNodeErrorRemover: [MORE: https://trello.com/c/YT3VbXpZ/15-durability-log-error] [ID: 3] (0M/2P/0I/0W/1A/0D/3T)
  50. - CooldownCrossSlotSync: [MORE: https://trello.com/c/65FPrTjK/12-no-cooldown-between-inventory-slots] [ID: 4] (0M/1P/0I/0W/0A/0D/1T)
  51. - ScrollSpeedImprovement: [MORE: https://trello.com/c/elL8IVdn/4-scroll-menus-are-insensitive] [ID: 5] (0M/1P/0I/0W/0A/0D/1T)
  52. ### API
  53. Basic engine registration and some events are exposed for modders to use.
  54. Documentation WIP...
  55. ## CLre_server
  56. CLre_server provides a minimal modding API, admin HTTP server, and bugfixes for the Cardlife server.
  57. ### Fixes
  58. As of v0.0.1, one (1) bugfix is implemented.
  59. - InitLogSooner: Start the logger slightly sooner than Cardlife does [TARGET: CustomLoggerThread] [ID: 0] (0M/2P/1I/0W/0A/0D/3T)
  60. ### API
  61. Basic engine registration and some events are exposed for modders to use.
  62. Documentation WIP...
  63. ### HTTP Server
  64. The HTTP server is enabled by the `-web` command line argument.
  65. It is disabled by default to reduce resource usage.
  66. When enabled, the server will listen on http://localhost:5030 and provide basic server status information.
  67. This can be accessed through any standard web browser on the same computer.
  68. If you wish to make this publicly accessible, it is recommended to use Nginx or another web proxy system to proxy traffic to that port securely.
  69. Useful endpoints
  70. ```text
  71. GET / HTML landing page with some basic server info
  72. GET /l/current Server output log, up-to-date as of last webpage refresh
  73. GET /d/version Cardlife, Unity and CLre version information
  74. GET /status.json Useful status information about players and server state in JSON format
  75. GET /c/game.json Basically GameServerSettings.json for the running Cardlife server
  76. ```