Aperture API for Forge 1.20.1

Professional toolkit for cinematic filming and animations in Minecraft.

If you create video content, develop adventure maps, or work on modding projects, Aperture API offers a powerful yet lightweight set of tools for creating smooth camera movements and scenes. No need to reinvent the wheel for filming building flyovers, showcasing bosses, or inserting cutscenes between events.

✨ Key Features

• Free Camera - Instantly detach from your character for filming of any complexity
• Keyframes and Trajectories - Create complex movement paths with position, rotation, focus distance, and duration settings for each frame
• Animation Smoothing - Natural transitions between positions using modern interpolation curves
• Timeline Editing - Combine multiple shots into a single cinematic sequence
• In-Game Editor - Full-screen interface with intuitive controls, tooltips, and precise sliders
• Developer API - Integration with your mods: programmatically trigger camera scenes from server or client side
• Versatility - JSON definitions support for reusing existing trajectories (in development)
• Multiplayer Compatibility - Correct client-side operation with remote management capabilities from server

🚉 Practical Applications

With this API you can:

• Create spectacular video presentations for modpacks and building projects
• Record YouTube content with professional motion fluidity
• Develop dramatic introductions for bosses and quest cutscenes
• Integrate camera transitions into other mod events (e.g., during battle phase changes)

🎮 Control Panel

The editor provides:

• Navigation headers for easy orientation
• Keyframe lists with add, copy, and reorganization functions
• Visual positioning and rotation hints
• Playback progress with instant preview

🛠️ For Developers

API is built on three core concepts:

• CameraShot - sequence of keyframes
• Keyframe - position, rotation, focus distance, and frame duration
• Easing - interpolation type control between points

Typical usage scenario: Create CameraShot programmatically (JSON loading planned), send to player from server or run locally. Additional callbacks allow synchronization of sound effects, animations, and events.

// Schematic API code (subject to change)
CameraShot shot = CameraShot.builder()
    .addKeyframe(new Keyframe(pos(10, 80, 10), rot(10f, 180f), fov(70f), duration(60)))
    .addKeyframe(new Keyframe(pos(20, 82, 20), rot(5f, 200f), fov(65f), duration(40)))
    .easing(Easing.QUAD_IN_OUT)
    .build();

ApertureApi.playFor(player, shot); // server-side activation
// or client-side: ApertureApi.playLocal(shot);

🔧 Configuration and Control

Comfortable operation ensured by:

• Customizable hotkeys for entering free camera mode
• Automatic exit upon taking damage
• Optimization for modern configurations and resource packs

📦 Installation

1. Ensure Minecraft Forge 1.20.1 is installed on client
2. Place Aperture API files in /mods folder
3. Configure hotkeys through Control Settings menu

Hardware dependencies absent - only standard Forge required.

🤝 Compatibility

Perfect for client-side singleplayer or multiplayer sessions. Server can request client trajectory playback according to security policy. Tip-scale development helps avoid conflicts with popular optimization and interface mods.

💡 Where to Use

• Arrival scenes for activating game bosses
• Spatial markers along adventure quest routes
• Automated tours across survival servers or creative spaces

❓ Common Questions

Q: Is this like Replay Mod with full event timeline recording?
A: No, the main purpose is creating camera movements that can be called from code or quickly assembled in-game.

Q: Does camera operation affect gameplay?
A: Filming mode is content-oriented for client side. Normal vulnerability remains - server can coordinate implementation.

Q: Are alternative platform adaptations planned?
A: Currently works on Forge 1.20.1, platform expansion considered for future.