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

1. Install WorldEdit on the NeoForge server.
2. Place the CGN SelectionView JAR file in the server's mods folder.
3. Restart the server.
4. 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

1. WorldEdit auf dem NeoForge-Server installieren.
2. Die CGN-SelectionView-JAR in den mods-Ordner des Servers legen.
3. Den Server neu starten.
4. 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.