Item Drops

Item Drops Plugin

A powerful, flexible item management and drop system for Godot games. Built with C# for maximum performance and reliability.

🎯 Quick Start

Installation

# Add to your Godot project
cp -r ItemDrops /path/to/your/godot/project/addons/

Basic Usage

using ItemDrops.Core.Generation;
using ItemDrops.Core.Types;

// Create a loot generator
var lootGenerator = new LootGenerator();

// Create drop context
var context = new DropContext();
context.SetData("PlayerLevel", 10);
context.SetData("LuckModifier", 1.2f);

// Generate loot from a drop table
var drops = lootGenerator.GenerateLoot(dropTable, context);

foreach (var drop in drops)
{
    Console.WriteLine($"Dropped: {drop.ItemId} x{drop.Quantity}");
}

📚 Documentation

🚀 For Users

🏗️ For Developers

  • Architecture - System architecture and design
  • Configuration - Configuration options
  • Implementation - Implementation details
  • GDScript Porting Source – The GDScript implementation under plugins/gameplay/ItemDrops/gdscript is an active porting source during the 6.0 migration, not a deprecated legacy tree. See docs/item-drops/ITEM_DROPS_GDSCRIPT_TO_CSHARP_PORTING.md for the ItemDrops-specific GDScript→C# porting plan.

✨ Features

  • 🎯 Smart Drop System - Intelligent item placement and physics
  • 📦 Inventory Management - Complete item handling and stacking
  • ⚙️ Customizable Rules - Flexible drop logic and conditions
  • 🔗 Integration Ready - Works with other plugins and systems
  • ⚡ High Performance - Optimized for real-time games
  • 🧪 Well Tested - Comprehensive test coverage

🎮 Use Cases

  • RPG Games - Loot drops and treasure chests
  • Survival Games - Resource gathering and crafting
  • Adventure Games - Collectibles and rewards
  • Action Games - Power-ups and bonuses
  • Simulation Games - Production and logistics

🚀 Getting Help

Ready to add item drops to your game? Check out our Getting Started guide!