Embers
An Ember defines how a game is installed, configured, started, monitored, and backed up. Multiple servers can share a definition while keeping separate values, resources, ports, and game data. For the native format, examples, and validation rules, see the Ember schema reference.
Create or edit an Ember
Choose Create Ember to use the visual editor, or select an existing definition to edit it. The steps cover basics, installation, runtime, variables, ports, configuration files, save-data paths, and review. JSON / YAML accepts pasted definitions; switching tabs preserves fields and the current step.
Import a definition
| Source | Supported versions |
|---|---|
| Native Ember | Schema 1 |
| Pterodactyl | PTDL_v1, PTDL_v2 |
| Pelican | PLCN_v1, PLCN_v2, PLCN_v3 |
- Open Embers → Import Ember and upload, paste, or enter a public HTTPS URL.
- Review compatibility notes and choose a startup command if multiple are offered.
- Resolve blocking errors and acknowledge warnings before importing.
- Create a server, review its image, values, resources, and ports, then test installation and startup before relying on it for a live game.
Import saves a definition; it does not download images, install a game, start it,
or accept an EULA. Use a self-contained export: inherited configuration or installer
scripts are unsupported. Unknown or missing format versions prevent import.
Empty Egg lists exported as [], {}, or null are accepted.
Conversion behavior
- Egg boolean variables retain
"1"/"0"values and display as toggles. - Plain
urlvalidation is preserved. Protocol-qualified rules such asurl:http,httpsare unsupported rather than silently discarded. eula,java_version,pid_limit, andsteam_disk_spacefeatures add predefined actionable error rules. Runtime selection and EULA acceptance remain explicit user actions. Alert rules require Spark log-alert support.- Eggs can include the
savedata_pathsextension; Campfire does not infer save paths from variables or scripts. - Game backup variables configure the game’s own behavior, not Campfire backup schedules, storage, or retention.
Warnings and blocking errors
Warnings identify behavior to review, such as ports or panel-specific features. Neither a warning acknowledgement nor successful conversion guarantees the image or installer will work. Converted runtime images need Bash and must support the startup command with their existing entrypoint.
Blocking errors indicate behavior Campfire cannot preserve: examples include inherited definitions, external mounts, privileged installers, custom log-file tailing, file denylists, unsupported parsers, unknown placeholders, and unsupported validation rules or regexes. Obtain a compatible export or adapt the definition; do not simply discard restrictions without understanding their purpose.
Definition updates
Definitions with a public update source can be checked and reviewed from Embers. Review and accept changes before replacing the local definition. Historical Ember versions are not retained.
Servers retain saved values. Changes to those values—including newly added optional values—require review in the server wizard. Definition-only changes synchronize independently, and backup paths use the latest declaration. Synchronization does not run the installer or restart games; container changes take effect on restart. Use reinstallation when game installation changes are needed. See applying an Ember update.