VisionCore (Paper Server Plugin)

Short Description (under 150 characters):

Paper plugin for 3D magic circles, runes, and visual effects. Works for vanilla players or with optional client mod for smooth hardware GPU rendering.

---

What is VisionCore?

VisionCore is a Paper server plugin that brings 3D visual effects to your Minecraft server without dropping TPS or forcing players to install client mods.

Whether you run an RPG server, an MMO arena, or a mini-game network, VisionCore handles the heavy lifting of geometric spell circles, rune rings, and energy barriers with zero client requirements.

---

Current Status: What is Active Now?

Active Now: 3D Visual Effects (VFX) The 3D magic circle and visual effect system is fully enabled, tested, and ready for production servers.

Under Active Development (Experimental): Player animations, custom 3D mobs, and cinematic camera tracks are currently experimental and in active development. These features will be enabled and documented in upcoming releases.

---

How Does It Work for Players?

VisionCore uses a hybrid dispatch model that supports both vanilla and modded players simultaneously:

• Vanilla Players (No Mod Required): Unmodded players see spell effects rendered through optimized dust particle rings and Display Entities. Everything works out of the box on standard vanilla Minecraft launchers.
• Fabric Modded Players (Optional): If a player installs the optional VisionCore companion mod, the server automatically routes them to GPU hardware rendering. The server sends a single compact binary packet (~45 to 120 bytes), and the client renders glowing 3D vector geometry at full framerate.

---

Active Features (Ready for Production)

3D Procedural Magic Circles and Runes

Summon complex spell circles, rune rings, and defense barriers in any 3D orientation:

• Ground seals (horizontal planes)
• Energy walls and barriers (vertical planes)
• Target-facing shields aligned perpendicular to the caster's line of sight
• 33 production presets included out of the box (mandalas, alchemy transmutation seals, clock dials, summoning circles, and defensive barriers)

Zero Server-Side Lag

• Effect geometry is calculated using fast pre-computed lookups.
• For modded clients, the server only sends tiny packet payloads instead of thousands of particle packets, keeping your network traffic and TPS clean.

Live Hot-Reloading

Edit presets or configuration files on the fly and run /vc reload. The server reloads changes instantly and updates connected modded clients without needing a restart.

---

Features In Development (Coming Soon)

The following systems are experimental and actively being developed for future releases:

• Player and Mob Animations: Keyframe animation playback for custom abilities, casting stances, and boss attacks (/vc anim).
• Custom Mobs and Decoupled Hitboxes: Custom 3D entity models, animated attack routines, and bone-attached hitboxes (/vc mob).
• Cinematic Camera Choreography: Camera cutscene sequences along smooth spline tracks for dungeon entries and boss intros (/vc camera).

---

In-Game Commands

All commands require the visioncore.admin permission (granted to server operators by default):

Active Commands

• /vc play <preset> [radius] [color] [duration] [orientation] - Summon a magic circle effect.
• /vc stop [player|all] - Cancel active spell effects on a player or across the server.
• /vc reload - Hot-reload configurations and preset blueprints from disk.

Experimental Commands (Under Development)

• /vc anim play <id> [player] [speed] [loop] - Play a skeletal animation (in development).
• /vc camera play <track> [player] - Play a cinematic camera cutscene (in development).
• /vc mob summon <mob_id> [x y z] - Spawn a configured custom boss (in development).

---

Installation and Requirements

• Server Software: Paper, Purpur, or Folia.
• Minecraft Version: 1.21.4 through 1.21.11+.
• Java: Java 21 or higher.
• Setup:
  1. Download visioncore-paper-1.0.0.jar.
  2. Place it into your server's plugins/ directory.
  3. Start or restart your server. Default configuration files and presets will generate in plugins/VisionCore/.