Built for Unturned server scripting
uScript focuses on adding custom gameplay logic to Unturned servers without compiling a traditional plugin for every change. It is commonly used for event logic, automation, integrations, and quick gameplay experiments.
General Info
uScript is aimed at server owners and developers who want to add unique behavior to their Unturned server.
- uScript can be used to add unique server content such as events, automations, and Discord-related integrations.
- The existing getting started guide places scripts directly in the server files, which keeps the editing loop simple for small gameplay changes.
- It fits well when you want faster iteration than building and deploying a full plugin for every tweak.
Folder Structure
The documented workflow uses a dedicated uScript directory inside your Unturned server files.
- Scripts are placed in `Servers/YourServer/uScript/Scripts`.
- Compatible DLL-based modules are placed in `Servers/YourServer/uScript/Modules`.
- Scripts in the Scripts directory are loaded automatically when the server starts.
Workflow
The setup is oriented around a quick edit-and-reload loop.
- Create a file with the `.uscript` extension in your Scripts directory.
- Use `/script reload` to reload all scripts without restarting the whole server.
- Multiple servers can be configured to share the same script, module, or data directory.
Where It Helps
uScript is most useful when you want server-specific behavior without a heavy deployment process.
- Prototype events, server-side automations, and utility features quickly.
- Keep custom logic close to the server files so non-plugin specialists can still maintain it.
- Extend a server with scripts while keeping reusable logic in optional modules when needed.