CGN SelectionView for WorldEdit

English

CGN SelectionView is a fully server-side NeoForge mod that visualizes WorldEdit cuboid selections using vanilla Minecraft particles.

The visualization is calculated on the server and sent only to the relevant player. No client-side mod is required.

Main features

Complete particle visualization of WorldEdit cuboid selections
Configurable outer edges and helper grid
Optional helper grid on the top, bottom and side surfaces
Four selectable particle styles
Per-player enable, disable and toggle commands
Native NeoForge permission nodes
Compatible with permission managers such as LuckPerms
Reloadable server configuration
Configurable render distance, update interval, particle limits and grid spacing
No client mod required

Supported versions

Minecraft: 26.1.2
NeoForge: 26.1.2.76
WorldEdit: 7.4.3
Java: 25

Installation

Install WorldEdit on the NeoForge server.
Place the CGN SelectionView JAR file in the server's mods folder.
Restart the server.
Edit the configuration file when needed:

config/cgn-selection-view-common.toml

Commands

`/cgnsv`

Shows the current status and command overview.

`/cgnsv on`

Enables the selection visualization for the current player session.

`/cgnsv off`

Disables the selection visualization for the current player session.

`/cgnsv toggle`

Switches the selection visualization on or off for the current player session.

`/cgnsv info`

Shows the installed version and active core settings.

`/cgnsv reload`

Reloads the server configuration without restarting the server.

Normal players can use the personal commands by default.

/cgnsv reload requires operator level 2 or the dedicated reload permission.

Permissions

CGN SelectionView registers native NeoForge permission nodes. A separate permission manager is optional.

Without an additional permission manager, NeoForge uses the default values listed below.

`cgnselectionview.use`

Master access to the personal commands.

Default: true

`cgnselectionview.toggle`

Access to /cgnsv on, /cgnsv off and /cgnsv toggle.

Default: true

`cgnselectionview.info`

Access to /cgnsv and /cgnsv info.

Default: true

`cgnselectionview.reload`

Access to /cgnsv reload without operator level 2.

Default: false

Operators with permission level 2 can always use /cgnsv reload.

LuckPerms example

The permission nodes are provided through NeoForge. LuckPerms can manage them when its NeoForge permission handler is installed.

/lp group default permission set cgnselectionview.use true
/lp group default permission set cgnselectionview.toggle true
/lp group default permission set cgnselectionview.info true
/lp group admin permission set cgnselectionview.reload true

To disable all personal CGN SelectionView commands for a group:

/lp group GROUPNAME permission set cgnselectionview.use false

Configuration

The configuration file is generated automatically on the first server start:

config/cgn-selection-view-common.toml

Existing configuration files are migrated automatically when required. Unrelated settings are retained.

Particle styles

The following four values can be used for both edgeParticleStyle and gridParticleStyle:

flame
orange_dust
red_dust
end_rod

Default configuration:

edgeParticleStyle = "flame"
gridParticleStyle = "orange_dust"

edgeDustScale = 1.25
gridDustScale = 0.8

`flame`

Animated orange flame particles.

`orange_dust`

Orange dust particles.

`red_dust`

Red dust particles.

`end_rod`

Bright white end-rod particles.

The scale values affect only orange_dust and red_dust. They have no effect on flame or end_rod.

Other configuration options

`defaultEnabled`

Default visualization state for every new player session.

`allowPlayerToggle`

Allows or blocks /cgnsv on, /cgnsv off and /cgnsv toggle.

`renderIntervalTicks`

Update interval in server ticks. 20 ticks equal one second.

`renderDistance`

Maximum distance at which particles are sent to the player.

`maxEdgeParticles`

Maximum particle budget for the outer edges per render pass.

`maxGridParticles`

Maximum particle budget for the helper grid per render pass.

`minimumEdgeSpacing`

Minimum spacing between particles on the outer edges.

`smallSelectionThreshold`

Maximum selection size that uses the small-selection grid spacing.

`smallGridSpacing`

Grid spacing for small selections.

`mediumSelectionThreshold`

Maximum selection size that uses the medium-selection grid spacing.

`mediumGridSpacing`

Grid spacing for medium selections.

`largeGridSpacing`

Grid spacing for large selections.

`gridTop`

Enables or disables the helper grid on the top surface.

`gridBottom`

Enables or disables the helper grid on the bottom surface.

`gridSides`

Enables or disables the helper grid on the side surfaces.

Default behaviour

The visualization is enabled by default for every new player session.

Player changes are intentionally session-based and are not stored permanently. After logout or a server restart, the configured default applies again.

Default technical values:

Render interval: 10 ticks
Render distance: 256 blocks
Outer edge particle budget: 280 particles per render pass
Helper grid particle budget: 300 particles per render pass
Minimum outer edge spacing: 0.65 blocks

Current limitations

WorldEdit cuboid selections only
Large grids are internally limited to prevent excessive line and particle generation
WorldEdit is required on the server

Other Minecraft versions

Minecraft 26.1.2 is currently supported.

Ports to other Minecraft and NeoForge versions can be requested. Please include the desired Minecraft, NeoForge and WorldEdit versions in the request.

Support and feedback

Bug reports, feature requests and port requests are welcome through the project's available support or issue channels.

License

MIT License

Notice

This is an independent community project and is not affiliated with or endorsed by EngineHub or the WorldEdit project.

Image disclosure

The project avatar is a stylized promotional image based on the mod's particle visualization. Gallery screenshots show the actual in-game result.

Deutsch

CGN SelectionView ist eine vollständig serverseitige NeoForge-Mod, die WorldEdit-Quaderauswahlen mit Vanilla-Minecraft-Partikeln sichtbar macht.

Die Darstellung wird auf dem Server berechnet und nur an den jeweiligen Spieler gesendet. Eine Client-Mod ist nicht erforderlich.

Hauptfunktionen

Vollständige Partikeldarstellung von WorldEdit-Quaderauswahlen
Einstellbare Außenkanten und Hilfsraster
Optionales Hilfsraster auf Oberseite, Unterseite und Seitenflächen
Vier auswählbare Partikelstile
Aktivieren, Deaktivieren und Umschalten pro Spieler
Native NeoForge-Permission-Nodes
Kompatibel mit Rechteverwaltungen wie LuckPerms
Config kann ohne Serverneustart neu geladen werden
Einstellbare Sichtweite, Aktualisierungsrate, Partikellimits und Rasterabstände
Keine Client-Mod erforderlich

Unterstützte Versionen

Minecraft: 26.1.2
NeoForge: 26.1.2.76
WorldEdit: 7.4.3
Java: 25

Installation

WorldEdit auf dem NeoForge-Server installieren.
Die CGN-SelectionView-JAR in den mods-Ordner des Servers legen.
Den Server neu starten.
Bei Bedarf die Konfigurationsdatei bearbeiten:

config/cgn-selection-view-common.toml

Befehle

`/cgnsv`

Zeigt den aktuellen Status und eine Befehlsübersicht.

`/cgnsv on`

Aktiviert die Auswahlanzeige für die aktuelle Spielersitzung.

`/cgnsv off`

Deaktiviert die Auswahlanzeige für die aktuelle Spielersitzung.

`/cgnsv toggle`

Schaltet die Auswahlanzeige für die aktuelle Spielersitzung um.

`/cgnsv info`

Zeigt die installierte Version und die aktiven Kerneinstellungen.

`/cgnsv reload`

Lädt die Server-Konfiguration ohne Serverneustart neu.

Normale Spieler können die persönlichen Befehle standardmäßig verwenden.

/cgnsv reload benötigt Operator-Level 2 oder die eigene Reload-Berechtigung.

Berechtigungen

CGN SelectionView registriert native NeoForge-Permission-Nodes. Eine zusätzliche Rechteverwaltung ist optional.

Ohne zusätzliche Rechteverwaltung verwendet NeoForge die unten angegebenen Standardwerte.

`cgnselectionview.use`

Hauptzugriff auf die persönlichen Befehle.

Standard: true

`cgnselectionview.toggle`

Zugriff auf /cgnsv on, /cgnsv off und /cgnsv toggle.

Standard: true

`cgnselectionview.info`

Zugriff auf /cgnsv und /cgnsv info.

Standard: true

`cgnselectionview.reload`

Zugriff auf /cgnsv reload ohne Operator-Level 2.

Standard: false

Operatoren mit Berechtigungsstufe 2 können /cgnsv reload immer verwenden.

LuckPerms-Beispiel

Die Permission-Nodes werden über NeoForge bereitgestellt. LuckPerms kann sie verwalten, wenn der NeoForge-Permission-Handler von LuckPerms installiert ist.

/lp group default permission set cgnselectionview.use true
/lp group default permission set cgnselectionview.toggle true
/lp group default permission set cgnselectionview.info true
/lp group admin permission set cgnselectionview.reload true

Alle persönlichen CGN-SelectionView-Befehle für eine Gruppe deaktivieren:

/lp group GRUPPENNAME permission set cgnselectionview.use false

Konfiguration

Die Konfigurationsdatei wird beim ersten Serverstart automatisch erzeugt:

config/cgn-selection-view-common.toml

Vorhandene Konfigurationsdateien werden bei Bedarf automatisch migriert. Nicht betroffene Einstellungen bleiben erhalten.

Partikelstile

Für edgeParticleStyle und gridParticleStyle können jeweils diese vier Werte verwendet werden:

flame
orange_dust
red_dust
end_rod

Standardkonfiguration:

edgeParticleStyle = "flame"
gridParticleStyle = "orange_dust"

edgeDustScale = 1.25
gridDustScale = 0.8

`flame`

Animierte orangefarbene Flammenpartikel.

`orange_dust`

Orangefarbene Dust-Partikel.

`red_dust`

Rote Dust-Partikel.

`end_rod`

Helle weiße Endstab-Partikel.

Die Größenwerte wirken nur bei orange_dust und red_dust. Bei flame und end_rod haben sie keine Wirkung.

Weitere Konfigurationsoptionen

`defaultEnabled`

Standardstatus der Anzeige für jede neue Spielersitzung.

`allowPlayerToggle`

Erlaubt oder sperrt /cgnsv on, /cgnsv off und /cgnsv toggle.

`renderIntervalTicks`

Aktualisierungsintervall in Server-Ticks. 20 Ticks entsprechen einer Sekunde.

`renderDistance`

Maximale Entfernung, in der Partikel an den Spieler gesendet werden.

`maxEdgeParticles`

Maximales Partikelbudget für die Außenkanten pro Renderdurchlauf.

`maxGridParticles`

Maximales Partikelbudget für das Hilfsraster pro Renderdurchlauf.

`minimumEdgeSpacing`

Minimaler Abstand zwischen Partikeln auf den Außenkanten.

`smallSelectionThreshold`

Maximale Auswahlgröße für den Rasterabstand kleiner Auswahlen.

`smallGridSpacing`

Rasterabstand für kleine Auswahlen.

`mediumSelectionThreshold`

Maximale Auswahlgröße für den Rasterabstand mittlerer Auswahlen.

`mediumGridSpacing`

Rasterabstand für mittlere Auswahlen.

`largeGridSpacing`

Rasterabstand für große Auswahlen.

`gridTop`

Aktiviert oder deaktiviert das Hilfsraster auf der Oberseite.

`gridBottom`

Aktiviert oder deaktiviert das Hilfsraster auf der Unterseite.

`gridSides`

Aktiviert oder deaktiviert das Hilfsraster auf den Seitenflächen.

Standardverhalten

Die Auswahlanzeige ist für jede neue Spielersitzung standardmäßig aktiviert.

Spieleränderungen gelten bewusst nur für die aktuelle Sitzung und werden nicht dauerhaft gespeichert. Nach dem Ausloggen oder einem Serverneustart gilt wieder der konfigurierte Standard.

Technische Standardwerte:

Aktualisierungsintervall: 10 Ticks
Sichtweite: 256 Blöcke
Partikelbudget der Außenkanten: 280 Partikel pro Renderdurchlauf
Partikelbudget des Hilfsrasters: 300 Partikel pro Renderdurchlauf
Minimaler Partikelabstand der Außenkanten: 0,65 Blöcke

Aktuelle Einschränkungen

Derzeit nur WorldEdit-Quaderauswahlen
Große Raster werden intern begrenzt, um übermäßige Linien- und Partikelmengen zu verhindern
WorldEdit wird auf dem Server benötigt

Weitere Minecraft-Versionen

Aktuell wird Minecraft 26.1.2 unterstützt.

Portierungen auf weitere Minecraft- und NeoForge-Versionen können angefragt werden. Bitte dabei die gewünschte Minecraft-, NeoForge- und WorldEdit-Version angeben.

Support und Feedback

Fehlermeldungen, Funktionswünsche und Portierungsanfragen sind über die verfügbaren Support- oder Issue-Kanäle des Projekts willkommen.

Lizenz

MIT-Lizenz

Hinweis

Dies ist ein unabhängiges Community-Projekt und steht nicht in Verbindung mit EngineHub oder dem WorldEdit-Projekt.

Bildhinweis

Das Projekt-Avatar ist eine stilisierte Werbegrafik auf Grundlage der Partikeldarstellung der Mod. Galerie-Screenshots zeigen das tatsächliche Ergebnis im Spiel.