MonolithAPI

Overview

Monolith API is a framework for creating custom blocks on Paper servers.

Instead of replacing vanilla mechanics or requiring a resource pack, Monolith allows plugins to register new logical block types based on vanilla materials while providing completely custom behavior.

Every custom block can react to events, be converted to and from an item, be placed into the world and retrieved later through the API.

The library is written in Kotlin but designed to be equally comfortable for Java developers.

🧭 Navigation

Explore the comprehensive documentation to master the API:

1. Getting Started

• Introduction & Features — Core philosophy and key capabilities.
• Installation Guide — Setting up Maven, Gradle, and plugin.yml.
• API Entry Point — How to access the API in Java and Kotlin.

2. Core Concepts

• Defining Custom Blocks — Creating your first BlockDefinition.
• Registration Lifecycle — Using MonolithRegisterEvent correctly.
• Items — Converting blocks to ItemStacks.

3. Advanced Mechanics

• Event System & Behaviors — Understanding global vs. local event dispatch.
• Persistent Data (DataContainer) — Saving custom state to blocks.
• Custom Data Types — Serializing complex objects.
• Vec3i — Advanced coordinate math and proximity checks.

4. World Management

• PlacedBlock API — Accessing blocks already in the world.
• Placement & Destruction — Programmatic world manipulation.
• Built-in Commands

Installation

plugin.yml

depend:
  - MonolithAPI

Maven

<dependency>
    <groupId>io.github.zawarka03</groupId>
    <artifactId>monolith-api</artifactId>
    <version>VERSION</version>
    <scope>provided</scope>
</dependency>

Gradle

dependencies {
    compileOnly("io.github.zawarka03:monolith-api:VERSION")
}