Skip to main content
Oyasai Server Platform includes 10 custom Minecraft plugins built with Kotlin for the Purpur 1.21 API. These plugins provide administrative tools, player features, and server utilities.

​
Available plugins

OyasaiUtilities

Core utility functions and helper methods for all plugins

OyasaiAdminTools

Admin commands for player and rank management

OyasaiPets

Pet summoning system with BigWolf feature

DynamicProfile

Dynamic player profiles and recommendations

EntityPose

Entity positioning and pose management

PaintTools

Creative painting and building tools

SocialLikes

Social interaction and like system (version 3)

SocialVotes

Player voting and poll system

TPswitch

Teleport switching and management

Vertex

Core plugin framework and utilities

​
Plugin architecture

All plugins follow a standard structure: 
plugins/<PluginName>/
├── build.gradle.kts          # Gradle build configuration
├── src/
│   └── main/
│       ├── kotlin/           # Kotlin source code
│       └── resources/
│           └── plugin.yml    # Plugin metadata

​
Build system

Plugins are built using Gradle with the Shadow plugin for creating fat JARs: 
# Build all plugins
gradle build --parallel

# Build specific plugin
gradle :plugins:OyasaiUtilities:build

​
Dependencies

Common dependencies available to all plugins:
  • Purpur API (1.21): Core server API
  • Vault API: Economy and permissions integration
  • TokenManager: Token-based economy (for specific plugins)
  • AdvancedBan: Ban system integration

​
Development

See Plugin Development for details on creating new plugins.

​
Deployment

Plugins are automatically included in server configurations through the Nix build system: 
oyasaiPurpur {
  plugins = with oyasai-plugins; [
    oyasaiutilities
    oyasaiadmintools
    oyasaipets
  ];
}

Build docs developers (and LLMs) love

Get started for freeTalk to us