# Scenes<\/p>\n
Restricts entity visibility to players inside WorldGuard regions.<\/p>\n
Large amounts of entities reduce client-side performance.
\nThis happens even if the entities are not visible, for example, if they are behind walls.<\/p>\n
## Installation<\/p>\n
This plugin requires **Paper 1.21.11**.<\/p>\n
Download and place the `Scenes.jar` file in your `plugins` folder.<\/p>\n
## Controlling visibility<\/p>\n
Scenes allows grouping entities using tags.
\nEntities without any tags are always visible.<\/p>\n
“`
\n\/scenes entity @e[type=armor_stand,sort=nearest,limit=1] tag add hello_world
\n“`<\/p>\n
Then, tags can be shown or hidden. This shows or hides all entities assigned to the tag.<\/p>\n
“`
\n\/scenes show hello_world
\n“`<\/p>\n
Instead of using a command, you can control tag visibility using the following integrations.<\/p>\n
### WorldGuard regions<\/p>\n
If WorldGuard is installed, tags can be added to WorldGuard regions using the `scenes` flag.
\nThis flag contains a comma-separated list of tags.<\/p>\n
Players will see any entities assigned to any tag of any region they are standing in.<\/p>\n
“`
\n\/rg flag my_region scenes hello_world,another_tag
\n“`<\/p>\n
### TrainCarts trains<\/p>\n
If TrainCarts is installed, tags can be added to trains using a TrainCarts sign.<\/p>\n
Passengers of a train will see any entities assigned to any tag which the train also has.<\/p>\n
“`
\n[+train]
\nscene show
\nhello_world
\nanother_tag
\n“`<\/p>\n
Each line can contain a single tag.
\nMore than two scene names can be specified by placing another sign below (just like the `announce` sign).<\/p>\n
| Sign | Description |
\n|—————|—————————————————————————————————-|
\n| `scene show` | Adds the specified scene tags to the train. Passengers will start seeing entities with those tags. |
\n| `scene hide` | Removes the specified scene tags from the train. |
\n| `scene set` | Replaces the list of scene tags of the train with the specified tags. |
\n| `scene clear` | Removes all scene tags from the train. |<\/p>\n
## Permissions<\/p>\n
| Permission | Description |
\n|—————————|—————————————————————————–|
\n| `scenes.assign.entity` | Allows assigning entities to scene tags using `\/scenes entity … tag …`. |
\n| `scenes.manual` | Allows using `\/scenes show` and `\/scenes hide` to manually show scene tags. |
\n| `scenes.traincarts.build` | Allows placing Scenes TrainCarts signs. |<\/p>\n
## API<\/p>\n
Scenes offers an API which allows other plugins to register their objects into scenes.<\/p>\n
### Gradle<\/p>\n
“`kotlin
\nrepositories {
\n maven(“https:\/\/repo.bundlegroup.gg\/repository\/maven-public\/”)
\n}<\/p>\n
dependencies {
\n compileOnly(“gg.bundlegroup.scenes:scenes-api:1.1.0”)
\n}
\n“`<\/p>\n
### Usage<\/p>\n
#### Controllers<\/p>\n
Controllers allow showing scene tags to players.
\nFor example, the built-in WorldGuard integration uses a controller to show scenes to players in certain regions.<\/p>\n
“`java
\nController controller = Scenes.get().createController(plugin);
\ncontroller.showTag(player, “hello_world”);
\n“`<\/p>\n
#### Elements<\/p>\n
Elements are objects which can be shown or hidden.
\nFor example, all entities are automatically registered as elements.<\/p>\n
“`java
\nElement element = Scenes.get().createElement(plugin, viewable);
\nelement.addTag(“hello_world”);
\n“`<\/p>\n
The passed `Viewable` object needs to implement these methods:<\/p>\n
“`java
\n@Override
\npublic void addViewer(Player player) {
\n}<\/p>\n
@Override
\npublic void removeViewer(Player player) {
\n}
\n“`<\/p>\n
Call `element.remove();` to unregister your element when it no longer exists.<\/p>\n","protected":false},"excerpt":{"rendered":"
Restricts entity visibility to players inside WorldGuard regions.<\/p>\n","protected":false},"featured_media":136083,"template":"","meta":{"_minecraft_slug":"scenes","_minecraft_project_id":"iGwO3Edz","_minecraft_author":"chezzer","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":25,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"scenes.zip","_minecraft_size_bytes":119601,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:18:33.737283Z","_minecraft_date_created":"2026-01-25T04:52:33.010665Z","_minecraft_date_modified":"2026-02-08T05:12:58.638989Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/scenes","_minecraft_icon_attachment_id":136083,"_minecraft_imported_at":"2026-06-08T00:54:17+00:00","_minecraft_import_hash":"44948fe1f623fc3259052272e56c45e5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127],"mod_loader":[132],"minecraft_version":[41],"class_list":["post-136082","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_loader-paper","minecraft_version-1-21-11"],"yoast_head":"\n