Discover AI-Generated Dungeons

Explore unique, dynamically generated dungeons powered by Google's Gemini AI

Download v0.2.0

Features

AI

AI-Generated Designs

Every dungeon is uniquely designed by Google's Gemini AI, creating limitless adventures.

Biomes

Biome-Specific Themes

Dungeons adapt to their environment with unique themes and architecture for each biome.

Bosses

Custom Boss Battles

Face challenging bosses with unique abilities and valuable rewards.

Treasure

Dynamic Loot System

Discover themed treasure with tiered rarity for balanced progression.

Integration

Plugin Integration

Works with popular mob plugins like MythicMobs, CustomMobs, and more.

Configuration

Highly Configurable

Extensive configuration options to customize the dungeon experience.

For Players

Finding Dungeons

Dungeons spawn naturally throughout your world as you explore. Look for unique entrances that match their biome's theme. Desert temples will be built with sandstone, forest dungeons with mossy stone and wood, and so on.

Each dungeon is procedurally generated with a unique layout and challenges!

Exploration

Each dungeon features several room types:

  • Entrance: The starting point of your journey
  • Corridors: Connecting passageways
  • Treasure Rooms: Containing valuable loot
  • Trap Rooms: Be careful of hazards!
  • Puzzle Rooms: Solve challenges for rewards
  • Boss Room: Face the dungeon's final challenge

Your exploration progress is tracked, so you can come back later to finish exploring.

Boss Battles

Each dungeon culminates in a unique boss battle. Bosses have special abilities and increased health, making them challenging opponents.

Defeating a boss rewards you with experience and rare loot. Players who help defeat a boss also receive rewards!

Dungeon Collapse

Once a dungeon is fully explored and the boss is defeated, it will begin to collapse after a configurable delay (default: 24 hours). Make sure to collect all valuable loot before this happens!

If you're inside a collapsing dungeon, you'll be notified and have 60 seconds to escape before being teleported to safety.

Player Commands

Command Description
/aid help Show help message with available commands
/aid list List all discovered dungeons
/aid info <dungeonId> Show detailed information about a specific dungeon

For Admins

Installation

Installing AIDungeon is simple:

  1. Download the latest version from the download section
  2. Place the JAR file in your server's plugins folder
  3. Restart your server
  4. Configure the plugin by editing plugins/AIDungeon/config.yml
  5. Get a Google Gemini API key and add it to the configuration (see API Setup)

The plugin requires Spigot/Paper 1.21.5 or later and Java 21 or later.

Configuration

AIDungeon is highly configurable. Here are the key settings:

Database Settings

Choose between SQLite (default) or MySQL:

database:
  type: sqlite  # or mysql
  # MySQL settings (only if using MySQL)
  host: localhost
  port: 3306
  name: aidungeon
  user: root
  password: ""

Generation Settings

Control how and where dungeons spawn:

generation:
  minDistanceBetweenDungeons: 500
  playerSightRange: 100
  dungeonSpawnChance: 0.2
  maxDungeonsPerRegion: 3
  maxRoomsPerDungeon: 15

Theme Settings

Configure dungeon themes:

themes:
  useBiomeThemes: true
  options:
    - ancient_temple
    - abandoned_mine
    - haunted_mansion
    # Add more themes here

Boss & Loot Settings

Adjust difficulty and rewards:

bosses:
  healthMultiplier: 10.0
  damageMultiplier: 2.0
  experienceDropped: 500

loot:
  chestsPerDungeon: 5
  rareItemChance: 0.2
  epicItemChance: 0.05
  legendaryItemChance: 0.01

Plugin Integration

Integrate with custom mob plugins:

custom_mobs:
  enabled: true
  plugin_priority:
    - "MythicMobs"
    - "CustomMobs"
    - "ItemsAdder"
    - "EcoPets"
    - "Citizens"

For a complete configuration guide, see the documentation.

Gemini API Setup

AIDungeon uses Google's Gemini API to create unique dungeons. Here's how to set it up:

  1. Visit Google AI Studio
  2. Sign in with your Google account
  3. Create a new API key from the dashboard
  4. Copy the API key and add it to your config.yml file:
gemini:
  apiKey: "YOUR_API_KEY_HERE"
  model: "gemini-1.5-pro"  # Default model

Available Models

Model Generation Time Best For
gemini-1.5-flash ~5-8 seconds High-traffic servers, limited resources
gemini-1.5-pro ~12 seconds Balanced performance and quality (default)
gemini-2.5-pro-experimental ~25-30 seconds Premium servers focused on quality

You can also use dynamic model selection based on server load:

gemini:
  peakHoursModel: "gemini-1.5-flash"
  offPeakModel: "gemini-1.5-pro"
  peakHoursStart: "16:00"  # 4 PM
  peakHoursEnd: "22:00"    # 10 PM

Admin Commands

AIDungeon provides several administrative commands:

Command Permission Description
/aid teleport <dungeonId> aidungeon.teleport Teleport to a dungeon entrance
/aid collapse <dungeonId> aidungeon.forcecollapse Force a dungeon to collapse
/aid scan aidungeon.forcescan Force a world scan for new dungeons
/aid pending aidungeon.admin List pending dungeon generation locations

Permission Management

To grant a player access to all admin commands, give them the aidungeon.admin permission. This is a parent permission that includes all other permissions.

Example with LuckPerms:

/lp user <username> permission set aidungeon.admin true

Or for a specific permission:

/lp user <username> permission set aidungeon.teleport true

PlaceholderAPI Integration

AIDungeon fully supports PlaceholderAPI, allowing you to display dynamic dungeon information in other plugins!

Available Placeholders

Placeholder Description Example Value
%aidungeon_total_dungeons% Total number of dungeons generated 42
%aidungeon_player_completed_dungeons% Dungeons completed by a player 7
%aidungeon_nearest_dungeon_distance% Distance to the nearest dungeon 234
%aidungeon_nearest_dungeon_theme% Theme of the nearest dungeon Ancient Temple
%aidungeon_dungeon_1_coords% Coordinates of the first dungeon -1024,64,2048

Integration Example

%aidungeon_player_completed_dungeons% Dungeons Explored
Nearest Dungeon: %aidungeon_nearest_dungeon_theme% (%aidungeon_nearest_dungeon_distance%m away)

Requirements

  • PlaceholderAPI plugin must be installed
  • AIDungeon plugin version 0.2.1 or later
  • No additional configuration needed

Download

AIDungeon v0.2.1

Latest release for Minecraft 1.21.5

  • AI-generated dungeons with unique layouts
  • Biome-specific themes and designs
  • Custom boss battles with special abilities
  • Dynamic loot system with tiered rarities
  • Integration with popular mob plugins
  • PlaceholderAPI integration
  • optional: possibility to help in development by submitting gemini-responses to a centralised Database

Requirements: Spigot/Paper 1.21+, Java 21+

Download v0.2.1

File size: 14 MB

Released: April 2025

Older Versions

"For Admins"