🌀 Neutrino (Freecam) v0.8

Neutrino is a lightweight server-side freecam plugin for Hytale that lets players detach their camera from their character for exploration, cinematic shots, and world inspection.

Built to stay minimal and reliable, Neutrino focuses on a clean freecam experience with optional permission-based access control.

⚙️ How it works

When freecam is enabled, your player camera switches to server camera mode, allowing independent camera movement while your character remains in place.

Freecam can be toggled on/off at any time, and Neutrino automatically cleans up active freecam state on disconnect and server shutdown.

An optional speed multiplier allows players to adjust camera movement speed dynamically.

⌨️ Commands

Player command

/freecam (/fc alias)
• Toggles freecam mode on/off
• Optional argument: speed (float)
• By default: available to all players

Usage examples:

/freecam → Toggle freecam
/freecam 2.0 → Set speed multiplier to 2.0x and toggle
/freecam 0.5 → Slower cinematic movement

Speed multiplier:

Minimum: 0.25
Maximum: 5.0
Default: 1.0

If a speed value is outside the allowed range, the command will reject it with a validation message.

Anchor command collection (WIP)

/freecamanchor (/fca alias)

Subcommands:

/fca set <id> → Save current camera position and rotation as an anchor
/fca remove <id> → Remove a saved anchor
/fca use <id> → Enter anchor camera view
/fca quit → Exit anchor camera view

Anchor config command (WIP)

/freecamanchorconfig enabled <true|false> (/fcac alias)
• Globally enable/disable all anchor functionality

🔐 Permissions

Neutrino v0.8.5 uses dedicated permission nodes:

Freecam

neutrino.command.freecam
neutrino.command.freecamconfig
neutrino.command.freecamconfig.usepermissionbehavior

Anchors (WIP)

neutrino.command.freecamanchor
neutrino.command.freecamanchor.set
neutrino.command.freecamanchor.remove
neutrino.command.freecamanchor.use
neutrino.command.freecamanchor.quit
neutrino.command.freecamanchorconfig
neutrino.command.freecamanchorconfig.enabled

Anchor limits can be controlled via:

neutrino.command.anchor.max.<number>
(Example: neutrino.command.anchor.max.5)

When permission behavior is enabled, players can only create as many anchors as allowed by their highest matching max permission node.

⚓ Anchors (WIP)

Anchors allow players to save specific camera positions (including world, coordinates, and rotation) and re-enter them later in a fixed camera view.

Current implementation includes:

Per-player anchor storage
Persistent save to config
World validation (anchors can only be used in the same world they were created in)
Safe world existence checks
Anchor ID validation (1–32 characters, letters/numbers/_/-)
Permission-based anchor limits
Global enable/disable toggle

When using an anchor:

The camera enters Anchor mode
The player's character remains in place
Speed multiplier still applies
The player can exit anchor mode with /fca quit

Anchors are currently considered experimental.

The feature is still being evaluated in terms of design clarity, UX consistency, and long-term reliability. Behavior, permissions, or structure may change significantly in future versions.

🎥 Typical use cases

Inspecting large builds
Recording videos
Taking cinematic screenshots
Creating fixed cinematic camera angles
Controlled scene framing

Neutrino is intended as a visual and exploration-focused tool.

✨ Features

Lightweight, minimal implementation
Simple toggle command (/freecam, /fc)
Optional speed multiplier argument
Optional permission-gated freecam behavior
Anchor system with per-player saved positions (WIP)
Runtime config toggles
Automatic cleanup on disconnect/shutdown

If you encounter issues or have suggestions, please report them on the project page.