Evertech Sandbox MOD template

a ready-to-use GitHub template for creating and maintaining mods for Evertech Sandbox.

provides automation for validation, exporting, and repository maintenance.

---

features

file validation

automatically validates project files through GHA triggers.

JSON

• syntax check
• schema check

Lua

• syntax check

export support

supports automated exports through GHA triggers.

submodule download

• stores submodule links in env
• downloads submodules using git submodule add

ZIP cleanup

• removes unnecessary files and folders (eg. */.git/, */.github/, *.md, etc.)
• moves all exported files and folders into a dedicated folder to avoid file pollution after ZIP extraction

fully functional template

includes preconfigured files that work in Evertech Sandbox out of the box.

---

usage

open GitHub in web browser (eg. Chrome, Edge, Opera, etc.)

click "use this template" to copy this repo as yours, without unwanted "folked" watermark.

make changes to your repo

validate files

• open GHA
• click "run" button

also, you could trigger GHA via pull requests.

export repo

• open GHA
• click "run" button.

---

credits

resource	description
Evertech Sandbox API doc	refers to official API documentation
json-schema-validator	validates JSON files against predefined schemas during GHA checks
extra-lua-preset	provides reusable Lua utilities
evtsbx-mod-lua-preset	provides Lua presets specifically designed for Evertech Sandbox MOD development