All information about this project can be found in our detailed documentation.
Create NPCs on your server that allow your players to access other subservers through the NPCs. Perform various actions such as sending messages, titles, or sounds, and use your favourite supported NPC provider such as Citizens or FancyNPCs.
- Custom Join NPC: Create NPCs to let your players join sub-servers seamlessly!
- Custom Inventories: Design the paginated inventory exactly the way you need it!
- Holograms: Add beautiful holograms above your NPCs!
- Placeholders: Use placeholders anywhere—in holograms, items, and more!
- Customize with Actions: Trigger messages, action bars, titles, sounds, and more when a player interacts with an NPC!
- Support for Other NPC Plugins: Integrate NPCs from other plugins like Citizens, FancyNPCs, and more!
- Use it as a Standalone: No third-party plugins needed—just drag and drop!
Install Citizens, FancyNPCs, or ZNPCsPlus, stand where the NPC should appear, and run:
/scnpcs create <id> <group-or-persistent-server> [provider]
For example, /scnpcs create lobby Lobby creates the provider NPC, links it to the
SimpleCloud target, writes its configuration, adds a default hologram, and makes
right-click join the target. If multiple creation providers are installed, add
citizens, fancynpcs, or znpcsplus to the command.
Target names do not need group: or ps: prefixes. A name that exists as both a
group and persistent server is rejected so that it can never resolve silently to
the wrong target.
Use /scnpcs edit <id> to discover the target, hologram, action, and pushback
editors. Existing provider NPCs can be attached with
/scnpcs link <id> <provider> <reference> <target>.
Run /scnpcs placeholders in-game for the current list. The placeholders shared
by group and persistent-server targets are:
<target_name>
<target_type>
<target_online_players>
<target_max_players>
<target_min_memory>
<target_max_memory>
<target_property:key>
Persistent servers also expose <target_id>, <target_pretty_name>, and
<target_motd>. Join-state values in NPC files are always written in lower case.
Contributions to SimpleCloud are welcome and highly appreciated. However, before you jump right into it, we would like you to read our Contribution Guide.
This repository is licensed under Apache 2.0.