nonscenes

A cutscene plugin for Minecraft 1.20.x - 1.21.x servers.

Note: This plugin has been written on Kottlin. It is currently in alpha development stage but is actively maintained and improved.

Features

• Record player movements to create cutscenes
• Play back recorded cutscenes
• Visualize cutscene paths with particles
• Multiple database support (SQLite, MySQL, PostgreSQL, MongoDB, Redis)

Installation

1. Download the latest JAR from releases
2. Place in your server's plugins/ folder
3. Install LuckPerms (required for permissions)
4. Restart your server

Building from Source

This project uses Gradle with Kotlin DSL. To build the plugin:

Prerequisites

• Java 21 or higher
• Gradle 8.5+ (or use the included wrapper)

Build Commands

# Clone the repository
git clone https://github.com/utophii/nonscenes.git
cd nonscenes

# Build the plugin
./gradlew build

# The JAR file will be created in build/libs/

Development

# Run tests
./gradlew test

# Clean build
./gradlew clean build

# Generate IDE files (for IntelliJ IDEA)
./gradlew idea

Commands

• /nonscene start <name> <frames> - Start recording a cutscene
• /nonscene play <name> - Play a cutscene
• /nonscene all - List all cutscenes
• /nonscene delete <name> - Delete a cutscene
• /nonscene showpath <name> - Show cutscene path

Permissions

• nonscene.use - Basic usage
• nonscene.start - Recording permission
• nonscene.play - Playback permission
• nonscene.delete - Delete permission
• nonscene.list - List permission
• nonscene.showpath - Path visualization permission
• nonscene.admin - All permissions

Configuration

The plugin creates config.yml and messages.yml in plugins/nonscenes/ on first run.

Database Setup

Default is SQLite. For other databases, edit config.yml:

storage:
  type: MYSQL  # or POSTGRESQL, MONGODB, REDIS
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: your_username
    password: your_password

Support

This is an alpha release. Report issues on GitHub.

License

MIT License