premium banner
A lightweight freecam utility that lets you detach from your player and freely explore the world in spectator-style mode.

Description

🌀 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.