NefactScripted (Add-On)

NefactScripted is the official add-on for NefactPlugin, built for creators producing scripted Minecraft content, roleplay events, cinematics, trailers, and YouTube series.

It provides production-focused tools for managing players, groups, kits, recording sessions, scripted events, casting sessions, and other behind-the-scenes systems directly from the server.

Features

Fake Players

• Configurable fake players in the TabList.
• Custom multiplayer server player count.
• Multiple random username generation styles.
• Automatic random ping generation.
• Configurable TabList sorting and positioning.
• Full configuration through config.yml.

Scripted Controls

• Toggle PvP on or off.
• Toggle player movement on or off.
• Mute or unmute the global chat.
• Global Trusted player system that bypasses scripted restrictions.

Groups

• Create and manage custom groups.
• Randomly split players into groups.
• Weighted group distribution.
• Automatic assignment for players joining after a split.
• Toggle colored glowing and nametags for every group.

Kits

• Complete built-in kit system.
• /kits graphical menu.
• Create, edit, preview, delete, and claim kits.
• Trusted-only kits.
• Permission-based kits.
• Per-kit cooldowns.
• Custom kit icons and menu positions.
• Full inventory, armor, and off-hand editor.
• Give kits to individual players or entire groups.

Recording Mode

• Lock the server while recording.
• Prevent new players from joining.
• Custom recording MOTD.
• Custom kick message.
• Recording status saved in config.yml.
• Optional admin bypass permission.
• Automatically save Recorder states when recording begins.

Recorder System

• Dedicated Recorder player list.
• Add or remove Recorders at any time.
• Configurable Recorder visibility.
• Hide Recorders from regular players while keeping them visible to Trusted players and other Recorders.
• Recorder visibility is automatically reapplied when players join.

Recording Saves

• Save complete player states before or during recordings.
• Manual and automatic recording snapshots.
• Restore previously saved player states.
• Interactive save browser.
• Inventory preview and save information.

Recording saves can include:

• Inventory.
• Armor.
• Off-hand.
• Ender Chest.
• Location and rotation.
• Game mode.
• Health.
• Hunger and saturation.
• Experience.
• Potion effects.
• Flight state.
• Fire ticks, air, and other player state data.

Immortality / Plot Armor

• Protect important scripted characters from accidental deaths.
• Configurable minimum health.
• Players still receive normal damage feedback.
• Totems continue to work normally.
• Immortality remains active after a Totem is used.
• Additional death-event protection for scripted scenes.

Event System

NefactScripted includes a global event framework for production sessions.

Supported events:

• Recording.
• Casting.
• Mocap.

Features include:

• Only one production event can be active at a time.
• Event-specific MOTDs.
• Join restrictions while an event is active.
• Configurable join bypass.
• Start and end titles.
• Start and end sound effects.
• Trusted players can bypass supported restrictions.
• Recorders are excluded from Recording event notifications for cleaner recording POVs.

Casting System

A complete system for organizing and running player castings directly inside Minecraft.

• Dedicated persistent Casting world.
• Automatic Casting world generation.
• Configurable Casting lobby spawn.
• Automatic player teleportation when Casting begins.
• Players are returned to their previous locations when Casting ends.
• Return locations survive disconnects and restarts.
• Automatically numbered Casting sessions.
• Persistent Casting history.
• Configurable Casting roles.

Default roles include:

• Actor.
• Builder.
• Redstone.
• PvP.

Casting Management

• Accept players into a Casting session.
• Assign candidates to their trials.
• Finish candidate trials and return them to the lobby.
• View accepted candidates from current or previous sessions.
• Paginated Casting lists.
• Interactive player removal with confirmation.
• UUID, name, role, and acceptance time are stored for accepted candidates.

Casting Stages

• Configure stage locations for roles such as Actor and PvP.
• Send players directly to configured stages.
• Assign candidates to their role-specific trial area.

Builder & Redstone Casting Plots

• Dedicated plot system for build-based Casting roles.
• Configurable plot spawn locations.
• Configurable plot boundaries.
• Automatic free plot allocation.
• Multiple candidates can use separate plots simultaneously.
• Candidates can only build inside their assigned plot.
• Admin bypass permission for plot restrictions.

Casting Plot Snapshots

• Save clean plots as reusable baselines.
• Archive candidate constructions before resetting a plot.
• Restore clean plots after a candidate finishes.
• Reset individual plots or all active plots.

Snapshots restore:

• Blocks.
• BlockData.
• Air.
• Container inventories.
• Signs and sign text.

Archived Casting Builds

Candidate builds are permanently stored by Casting session.

• Browse archived builds from previous Castings.
• Load an archived build back into its original plot.
• Review candidate work later.
• Restore the clean plot after reviewing a build.

Designed for creators

Unlike normal gameplay plugins, NefactScripted focuses on production, recording, server management, and scripted content creation.

It is designed to reduce the amount of manual server administration required during recordings while keeping production tools centralized, configurable, and integrated with NefactPlugin.

Requirements

• NefactPlugin
• PacketEvents

Commands

Main

• /nefactscripted reload
• /ns reload

Controls

• /ns pvp <on|off|status>
• /ns movement <on|off|status>
• /ns chat <on|off|status>

Trusted

• /ns trusted add <player>
• /ns trusted remove <player>
• /ns trusted list

Groups

• /ns group create <name> <color>
• /ns group delete <group>
• /ns group edit <group>
• /ns group split
• /ns group display <enable|disable|status>

Kits

• /kits
• /kits create <name> [--icon <item>]
• /kits edit <kit>
• /kits delete <kit>
• /kits give <kit> <player>
• /kits give <kit> --group <group>

Recording

• /record <on|off|status>
• /record save [name]
• /record saves
• /record restore <save-id>
• /record delete <save-id>

Recorders

• /recorder add <player>
• /recorder remove <player>
• /recorder list
• /recorder visibility <on|off|status>

Immortality

• /ns immortality add <player>
• /ns immortality remove <player>
• /ns immortality list

Events

• /recording
• /casting
• /mocap
• /forcejoininevent

Casting

• /ns setspawn
• /casting list [casting-id]
• /casting builds [casting-id]
• /cast accept <player> <role>
• /cast assign <player> <role>
• /cast finish <player>
• /cast setstage <role>
• /cast send <player> <role>
• /cast setplot <role> <id>
• /cast setplotcorner <role> <id> <1|2>
• /cast saveplot <role> <id>
• /cast resetplot <role> <id>
• /cast resetplots
• /cast restoreplot <role> <id>

Permissions

General

• nefactscripted.command
• nefactscripted.command.reload

Controls

• nefactscripted.command.pvp
• nefactscripted.command.movement
• nefactscripted.command.chat
• nefactscripted.command.trusted

Groups

• nefactscripted.command.group

Kits

• nefactscripted.kit.use
• nefactscripted.kit.admin

Recording

• nefactscripted.record.admin
• nefactscripted.record.bypass
• nefactscripted.record.save

Recorders

• nefactscripted.recorder.admin

Immortality

• nefactscripted.command.immortality

Events

• nefactscripted.event.recording
• nefactscripted.event.casting
• nefactscripted.event.mocap
• nefactscripted.event.forcejoin
• nefactscripted.event.join.bypass

Casting

• nefactscripted.cast.admin
• nefactscripted.command.setspawn
• nefactscripted.cast.plot.bypass