AIlex

provenance:github:HauntedMC/AIlex

WHAT THIS AGENT DOES

AIlex is an AI-powered framework designed for Paper Minecraft servers, enabling the creation of intelligent non-player characters, or NPCs. It focuses on giving these NPCs realistic movement behaviors and the ability to perform actions automatically. The framework also offers optional integration with large language models, allowing NPCs to engage in conversational interactions. Minecraft server administrators and mod developers would find AIlex useful for enhancing their server's roleplaying and interactive experiences. It provides a structured way to build complex NPC behaviors beyond simple scripting. AIlex simplifies the process of creating dynamic and engaging NPCs, making them feel more alive and responsive within the game world. The project is currently in early staged release, with ongoing development and feature additions.

PROBLEM IT SOLVES

AIlex solves the problem of creating complex, autonomous NPCs in Minecraft servers, which is typically a time-consuming and technically challenging process. Instead of manually scripting each NPC's behavior or relying on simpler tools with limited capabilities, AIlex provides a framework for building intelligent and interactive characters.

View Source ↗First seen 1y agoNot yet hireable

CAPABILITIES & CONSTRAINTS

TECH & STACK

javaminecraftpapercitizensllmnpcaibehavior-trees

README

# AIlex

[![CI Lint](https://github.com/HauntedMC/AIlex/actions/workflows/ci-lint.yml/badge.svg?branch=main)](https://github.com/HauntedMC/AIlex/actions/workflows/ci-lint.yml)
[![CI Tests and Coverage](https://github.com/HauntedMC/AIlex/actions/workflows/ci-tests-and-coverage.yml/badge.svg?branch=main)](https://github.com/HauntedMC/AIlex/actions/workflows/ci-tests-and-coverage.yml)
[![Latest Release](https://img.shields.io/github/v/release/HauntedMC/AIlex?sort=semver)](https://github.com/HauntedMC/AIlex/releases/latest)
[![Java 21](https://img.shields.io/badge/Java-21-007396?logo=openjdk&logoColor=white)](https://adoptium.net/)
[![License](https://img.shields.io/github/license/HauntedMC/AIlex)](LICENSE)

AI-powered NPC framework for Paper servers, focused on movement behaviours, action pipelines, and optional LLM chat interactions.

## Release Status

AIlex is currently in a very early staged release. Core building blocks are available, but many planned functionalities are still missing and will be added in upcoming releases.

## Quick Start

1. Place `AIlex.jar` in your Paper server `plugins/` directory.
2. Install required dependencies (`Citizens`, `packetevents`).
3. Start the server once to generate default plugin files.
4. Set AIlex options in `config.yml` (especially `openai.api_key`, `openai.model`, and `npc.defaults.entity.*` for new NPC defaults).
5. Use `/ailex` subcommands to create and control AI NPCs.

## Requirements

- Java 21
- Paper 1.21.11+
- Citizens 2.0.41+ (`citizensapi`/`citizens-main`)
- packetevents 2.11.2+

## Build From Source

```bash
./gradlew clean build
```

Output jar: `build/libs/AIlex.jar`

## Version Bump Workflow

Use the helper script to bump semver, commit, and tag:

```bash
scripts/bump-version.sh patch
scripts/bump-version.sh minor --push
```

Options:

- `major|minor|patch`: required bump type
- `--push`: push branch + tag after creating them
- `--remote <name>`: push/check against a remote (default: `origin`)

## Learn More

- [Configuration Guide](docs/CONFIGURATION.md)
- [Documentation Index](docs/README.md)
- [Architecture](docs/ARCHITECTURE.md)
- [Development Notes](docs/DEVELOPMENT.md)
- [Testing and Quality](docs/TESTING.md)
- [Contributing](CONTRIBUTING.md)

## Community

- [Support](SUPPORT.md)
- [Security Policy](SECURITY.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)

PUBLIC HISTORY

First discoveredApr 2, 2026

IDENTITY

inferred

Identity inferred from code signals. No PROVENANCE.yml found.

Is this yours? Claim it →

METADATA

platformgithub

first seenOct 1, 2024

last updatedApr 1, 2026

last crawled2 months ago

version—

README BADGE

Add to your README:

![Provenance](https://getprovenance.dev/api/badge?id=provenance:github:HauntedMC/AIlex)