CLre/README.md

165 lines
8.5 KiB
Markdown
Raw Normal View History

2020-10-01 14:46:16 +01:00
# CLre
2020-10-01 14:21:44 +01:00
2020-10-01 15:00:48 +01:00
Always eat your celery, so you'll grow up to be big and strong like me.
2021-08-30 17:18:49 +01:00
Work-in-progress mod for [Cardlife](http://Cardlifegame.com/).
2020-10-01 15:00:48 +01:00
2021-08-30 17:18:49 +01:00
Cardlife has stopped receiving updates, but that doesn't mean it's free from bugs.
CLre is a mod to rejuvenate Cardlife by fixing old bugs and adding some modding sprinkles.
2020-10-01 14:21:44 +01:00
2021-08-30 17:18:49 +01:00
## Development
2020-10-01 14:21:44 +01:00
2021-08-30 17:18:49 +01:00
### Setup
This project requires most of Cardlife's `.dll` files to function correctly.
Most, but not all, of these files are stored in Cardlife's `Cardlife_Data\Managed` folder.
2020-10-01 15:00:48 +01:00
The project is pre-configured to look in a folder called cl in the solution's main directory or one level up from that.
2020-10-01 14:21:44 +01:00
2021-08-30 17:18:49 +01:00
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.
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.
2020-12-28 18:38:59 +00:00
For example, if you cloned the repo into a folder called `CLre_repo`, this is what your folder structure would look like.
2021-03-18 19:30:30 +00:00
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.
2020-10-01 15:00:48 +01:00
```
2020-12-28 18:38:59 +00:00
CLre_repo/ <- CLre git project files
CLre/ <- Code files
README.md <- This file
2020-10-01 15:00:48 +01:00
etc.
2021-08-30 17:18:49 +01:00
cl/ <- Cardlife files
2020-10-01 15:00:48 +01:00
Cardlife_Data/
2020-12-28 18:38:59 +00:00
Managed/ <- Cardlife C# Assemblies
CardlifeGameServer_Data/
2021-03-18 19:30:30 +00:00
Managed/ <- Cardlife Server C# Assemblies (optional)
2020-10-01 15:00:48 +01:00
```
2020-10-01 14:21:44 +01:00
2021-08-30 17:18:49 +01:00
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).
2021-08-30 23:00:56 +01:00
For a server mod to work, you will have to patch the server (CardlifeGameServer.exe).
The installation process is below, or you can follow the instructions for Gamecraft: [GCIPA Gamecraft install guide](https://git.exmods.org/modtainers/GCIPA/src/branch/master/README.md#how-to-install).
2020-10-01 14:21:44 +01:00
2021-08-30 17:18:49 +01:00
### Building
2020-10-01 14:21:44 +01:00
2020-10-01 14:46:16 +01:00
After you've completed the setup, open the solution file `CLre.sln` in your prefered C# .NET/Mono development environment.
I'd recommend Visual Studio Community Edition or JetBrains Rider.
2020-10-01 14:21:44 +01:00
2020-10-01 14:46:16 +01:00
If you've successfully completed setup, you should be able to build the CLre project without errors.
2020-12-28 18:38:59 +00:00
If it doesn't work and you can't figure out why, ask for help on the [Exmods Discord server](https://discord.exmods.org).
2020-10-01 14:21:44 +01:00
## Installation
To patch Cardlife to load mods, download the latest version of [CLIPA](https://git.exmods.org/NGnius/CLIPA/releases), extract the contents into the game folder, then drag `Cardlife.exe` onto `IPA.exe`. Once the terminal window closes, drag `CardlifeGameServer.exe` onto `IPA.exe`.
If you haven't turned on "Show file extensions" in Windows, those files may appear to be named `Cardlife`, `CardlifeGameServer`, and `IPA`.
2021-08-30 23:00:56 +01:00
Some antivirus software may (wrongly) claim that `IPA` is a virus, but those warnings can be dismissed.
If you don't believe me, read the [CLIPA source code](https://git.exmods.org/NGnius/CLIPA).
To install the CLre mod, copy `CLre.dll` and `0Harmony.dll` (from the release zip) into the `Plugins` folder in the Cardlife install directory.
To install the CLre_server mod, copy `CLre_server.dll` and `0Harmony.dll` (from the release zip) into the `Plugins` folder where Cardlife is installed.
2021-03-18 19:30:30 +00:00
## A Note on CLre and CLre_server mods' (lack of) cooperation
2021-08-30 23:00:56 +01:00
CLre is designed for the Cardlife client, and cannot be used with the Cardlife server.
Similarly, CLre_server is designed for the Cardlife server, and cannot be used with the Cardlife client.
2021-03-18 19:30:30 +00:00
DO NOT install CLre and CLre_server in the same `Plugins` folder, because both mods will be loaded -- guaranteeing one will break.
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.
# Functionality
## CLre
2021-08-30 17:18:49 +01:00
CLre provides a minimal modding API and useful bugfixes for the Cardlife client.
2021-03-18 19:30:30 +00:00
### Fixes
As of v0.0.3, elevent (11) bugfixes are implemented.
2021-08-30 17:18:49 +01:00
2021-03-18 19:30:30 +00:00
- InitLogSooner: Start the logger slightly sooner than Cardlife does [TARGET: CustomLoggerThread] [ID: 0] (0M/2P/1I/0W/0A/0D/3T)
- EnchantmentTableFloatParseFix: [MORE: https://trello.com/c/qawBFb7P/1-enchantment-table-fails-to-work] [ID: 1] (0M/2P/0I/0W/0A/0D/2T)
- ExclusionImprovement: [MORE: https://trello.com/c/Ue4yIqWQ/11-placing-material-in-restricted-areas] [ID: 2] (0M/2P/0I/0W/0A/0D/2T)
- ClientDurabilityNodeErrorRemover: [MORE: https://trello.com/c/YT3VbXpZ/15-durability-log-error] [ID: 3] (0M/2P/0I/0W/1A/0D/3T)
- CooldownCrossSlotSync: [MORE: https://trello.com/c/65FPrTjK/12-no-cooldown-between-inventory-slots] [ID: 4] (0M/1P/0I/0W/0A/0D/1T)
- ScrollSpeedImprovement: [MORE: https://trello.com/c/elL8IVdn/4-scroll-menus-are-insensitive] [ID: 5] (0M/1P/0I/0W/0A/0D/1T)
2021-05-15 16:13:02 +01:00
- MiniScreenEmbiggener: [MORE: https://trello.com/c/NAls3XaE/17-game-starts-minimized-and-wont-restore] [ID: 6] (0M/0P/1I/0W/0A/0D/1T)
- UnderStructureCollider: [MORE: https://trello.com/c/nfuaZWQZ/10-passing-through-structures] [ID: 7] (1M/1P/1I/0W/0A/0D/3T)
2021-08-30 17:18:49 +01:00
- TerrainModificationFailedHandler: [MORE: https://trello.com/c/Pq5lcB1p/23-moderation-tools] [ID: 8] (0M/2P/1I/1W/0A/2D/6T)
- OfflineSpawnpointSavingFloatFix: [MORE: https://trello.com/c/hpADhDhQ/21-login-goes-to-original-spawn] [ID: 9] (0M/2P/0I/0W/0A/0D/2T)
- OfflineGameTimeSavingFloatFix: Make game time save properly for everyone, even when floats contain a comma [ID: 11] (0M/1P/0I/0W/0A/0D/1T)
2021-08-30 23:00:56 +01:00
The offline fixes actually correct issues in the game server while running offline,
which is why `CardlifeGameServer.exe` must be patched for CLre to work (not just for CLre_server).
2021-03-18 19:30:30 +00:00
### API
Basic engine registration and some events are exposed for modders to use.
2021-08-30 17:18:49 +01:00
Documentation WIP... (read the code files in the `CLre/API` directory for now)
2021-03-18 19:30:30 +00:00
## CLre_server
CLre_server provides a minimal modding API, admin HTTP server, and bugfixes for the Cardlife server.
### Fixes
2021-08-30 17:18:49 +01:00
As of v0.0.3, one (1) bugfix is implemented.
2021-03-18 19:30:30 +00:00
- InitLogSooner: Start the logger slightly sooner than Cardlife does [TARGET: CustomLoggerThread] [ID: 0] (0M/2P/1I/0W/0A/0D/3T)
### API
Basic engine registration and some events are exposed for modders to use.
2021-08-30 17:18:49 +01:00
Documentation WIP... (read the code files in the `CLre_server/API` directory for now)
### Tweaks
CLre_server also offers a few improvements for the Cardlife server.
These are not bugfixes, but are quality-of-life additions to bring server functionality up to par with other game servers.
Improvements can be enabled and customized by modifying the `CLre_server.json` configuration file in Cardlife's install directory.
2021-03-18 19:30:30 +00:00
2021-08-30 17:18:49 +01:00
#### HTTP Server
2021-03-18 19:30:30 +00:00
2021-08-30 17:18:49 +01:00
The HTTP server is enabled by the `-web` command line argument, or in `CLre_server.json`.
2021-03-18 19:30:30 +00:00
It is disabled by default to reduce resource usage.
When enabled, the server will listen on http://localhost:5030 and provide basic server status information.
This can be accessed through any standard web browser on the same computer.
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.
Useful endpoints
2021-08-30 17:18:49 +01:00
2021-03-18 19:30:30 +00:00
```text
GET / HTML landing page with some basic server info
GET /l/current Server output log, up-to-date as of last webpage refresh
GET /d/version Cardlife, Unity and CLre version information
GET /status.json Useful status information about players and server state in JSON format
GET /c/game.json Basically GameServerSettings.json for the running Cardlife server
2021-05-15 16:13:02 +01:00
```
2021-08-30 17:18:49 +01:00
#### Server Commands
CLre_server can accept chat commands from connected players.
Chat commands can be enabled in `CLre_server.json`.
For this functionality to work, valid user credentials must also be configured.
Commands
```text
/echo <msg> - say <msg>
/help - show a list of commands
/list - display online users
/version - display version information
/ban <user> - permanently remove <user> from this server
/deop <user> - revoke <user> moderator permissions
/kick <user> - disconnect <user> from this server
/op <user> - grant <user> moderator permissions
```
#### Terrain Modification Exclusion Zone
This exclusion zone improvement can be enabled in `CLre_server.json`.
This prevents players from digging under a building that they do not own.
This improves on the existing exclusion zone functionality which already prevents a player from placing materials and building structures too close to another player's building.
#### CLre-only Mode
To prevent vanilla clients from connecting to this server, enable this restriction in `CLre_server.json`.
Enabling this functionality is not recommended.
This functionality should only be used when other code mods are installed which break compatibility with unmodded Cardlife clients.