_____ _
/ __ \ | |
| / \/_ __ ___ __ _| |_ _ _ _ __ ___
| | | '__/ _ \/ _` | __| | | | '__/ _ \
| \__/\ | | __/ (_| | |_| |_| | | | __/
\____/_| \___|\__,_|\__|\__,_|_| \___|
_____ _ _.-""""""""-._
/ __ \ | | .' (@) (#) '.
| / \/ ___ | | ___ _ __ ___ / (%) .--. (*) \
| | / _ \| |/ _ \| '__/ __| | (o) ( ) |
| \__/\ (_) | | (_) | | \__ \ \ (&) '--' _.-'
\____/\___/|_|\___/|_| |___/ '._ (+) .-'
'-._____.-'
Server plugin that lets players recolor their own or their tribe's tames with chat commands, save a creature's colors as a named template, and apply it to every tame of the same species around them. Access is an individual perk gated by a Permissions permission; templates are stored in MariaDB or SQLite.
Status: complete Both versions are tested and running in production. This software will receive only bug fixes for future game state version updates. No new feature sets will be added beyond what is presented here.
| Folder | Game | Server API (submodule) | Player key |
|---|---|---|---|
ASA |
ARK: Survival Ascended | AsaApi at ASA/extern/AsaApi |
EOS ID |
ASE |
ARK: Survival Evolved | ArkServerApi (AseApi) at ASE/extern/AseApi |
SteamID64 |
All commands need the permission set in config.json (Permission). Only the player's own groups count,
never tribe groups. Command names can be changed in config.json, and every reply goes only to the
player who ran the command. Template names are 1-32 characters (letters, numbers, - and _) and
are not case-sensitive.
Sets one color region on the tame you're looking at.
regionis 0-5 and must be a region that species actually paints. Regions the species doesn't use (left blank in the inspect panel, such as a Raptor's region 2) are refused.coloris a color ID: ASA 1-100 and 128-254, ASE 1-100 and 201-226.- The tame must belong to you or your tribe; wild creatures and other tribes' tames are refused.
- Example:
/setcr 0 79
Saves all six regions of the tame you're looking at as a template under your own player ID.
- The template remembers the creature's species; regions that species doesn't use are stored as unused and are never painted when the template is applied.
- If you already have a template with that name, you're asked whether to overwrite it. Answer with
/yto overwrite or/nto cancel; with no answer within 30 seconds the save is cancelled. - Example:
/savecrt firestripe
Applies one of your templates to every tame around you of the same species.
- Only exact species matches are colored. Variants count as different species, so a Raptor template doesn't apply to an Aberrant Raptor. Other species in range are skipped and counted in the reply.
- Only tames owned by you or your tribe are touched.
radiusis in Unreal units: default 300 (1 foundation), maximum 3000 (10 foundations). A larger number runs at the maximum with a notice; anything that isn't a whole number above 0 shows usage.- Example:
/setcrtaoe firestripe 1500
Lists your saved templates.
- Looking at a creature: shows only templates for that exact species.
/listcrt rex: shows species whose short name contains the text (the short name is the blueprint class without_Character_BP, for exampleRex,Raptor_Aberrant,Quetz,Argent).- Neither: shows everything, grouped by species, e.g.
Raptor: blue, red | Rex: fire, ice. - Long lists are split across numbered chat messages
(1/3); after the configured limit the rest is summarized as...and N more.
Deletes one of your templates. You can only delete your own; a name that doesn't exist is reported.
It also cancels a pending /savecrt overwrite prompt for the same name.
- Example:
/delcrt firestripe
Answer the overwrite prompt from /savecrt. They're commands rather than plain chat so the answer
never appears in global chat; outside a prompt they report that nothing is waiting.
Each folder is a self-contained Visual Studio solution. Clone with submodules:
git clone --recurse-submodules https://github.com/bushome/CreatureColors.git
or, in an existing clone:
git submodule update --init --recursive
The commands (/setcr, /savecrt, /setcrtaoe, /listcrt, /delcrt), src/Config.h and config.json
are the same in both folders. src/Main.cpp, src/DinoColors.h, src/PermissionsApi.h, the storage
backends and the project files differ by API, and the template table is keyed by eos_id on ASA and
steam_id on ASE. Valid color IDs also differ by game (ASA 1-100 and 128-254, ASE 1-100 and 201-226).
Install, commands, configuration, the optional decay-cleanup triggers and build steps are in each
folder's README and docs/; STATUS.md has the test results for both versions.
Developed with AI assistance (Claude). Every change was reviewed and tested on a dedicated test server before going live.