KodariDocs

Official documentation service for Kodari.ai - providing AI with up-to-date API knowledge for Minecraft plugin development.

What is this?

This microservice serves API documentation that helps Kodari understand the latest Minecraft/Bukkit/Spigot/Paper APIs without relying on outdated training data.

Contributing Documentation

We welcome community contributions! Add your documentation to help make Kodari smarter.

Quick Start

1. Fork this repository
2. Add your .md file to src/main/resources/docs/
3. Submit a pull request

Documentation Format

Create markdown files with clear API references:

# YourPlugin API

## Classes

### com.example.YourMainClass
Methods:
- void doSomething(String param)
- String getSomething()

Naming Convention

• File: your-plugin-name.md (lowercase, hyphens)
• Content: Focus on method signatures and basic usage

Auto-generating Documentation

We provide a tool to automatically generate docs from JAR files.

Using the Auto-generator

1. Place your JAR files in autogen/src/main/resources/input/
2. Run from project root:

   ./gradlew :autogen:run

3. Check autogen/src/main/resources/output/ for generated docs
4. Review and copy good docs to src/main/resources/docs/

Example

# Clone the repo
git clone https://github.com/KodariAI/kodaridocs.git
cd kodaridocs

# Add your JAR
cp ~/spigot-api-1.20.4.jar autogen/src/main/resources/input/

# Generate docs
./gradlew :autogen:run

# Check output
cat autogen/src/main/resources/output/spigot-api-1.20.4.md

Running Locally

Prerequisites

1. Create a .env file in the project root:

   cp .env.example .env

2. Add your Anthropic API key to .env:

   ANTHROPIC_API_KEY=your-api-key-here

3. Start the service:

   ./gradlew bootRun

Test Endpoints

# List available docs
curl http://localhost:8083/api/v1/available-docs

# Get specific doc
curl http://localhost:8083/api/v1/docs/minecraft-commands

API Endpoints

• GET /api/v1/available-docs - List all available documentation
• GET /api/v1/docs/{docId} - Get specific documentation

Example Responses

GET /api/v1/available-docs

[
  "luckperms"
]

GET /api/v1/docs/bukkit-api

{
  "content": "# Luckperms API Reference\n\n## Package: net.luckperms...",
  "tokens": 4523
}

Guidelines

• ✅ DO contribute API references and method signatures
• ✅ DO include basic usage examples
• ✅ DO keep docs factual and concise
• ❌ DON'T include tutorials or opinions
• ❌ DON'T commit JAR files
• ❌ DON'T include sensitive information

License

MIT License

---

Built with ❤️ for the Minecraft development community by Kodari.ai