promotional bannermobile promotional banner

Inventory Manager API

Inventory Manager API allows you to save/load inventories, extending inventory functionalities

File Details

InventoryManagerAPI-1.1.0.jar

  • R
  • Jan 21, 2026
  • 1.51 MB
  • 222
  • Early Access

File Name

InventoryManagerAPI-1.1.0.jar

Supported Versions

  • Early Access

Added

  • PostgreSQL Storage Support: New alternative storage backend for inventory persistence

    • StorageType enum (Json, PostgreSQL) to switch between storage backends
    • PostgreSQLConfig class with configurable connection settings:
      • Host (default: localhost)
      • Port (default: 5432)
      • Database (default: postgres)
      • Username (default: postgres)
      • Password (default: empty)
      • TableName (default: inventories)
    • PostgreSQLInventoryStorage implementation using HikariCP connection pooling
  • Enhanced Configuration

    • New StorageType field in InventoryManagerConfig to select storage backend
    • New PostgreSQL nested configuration object for database settings
  • Improved Config View Command

    • /invm config view now displays storage-specific settings
    • Shows JSON storage directory when using JSON backend
    • Shows PostgreSQL connection details (host, port, database, username, table) when using PostgreSQL backend

Changed

  • Plugin Path Resolution: Updated to follow Hytale standards

    • Manifest Group changed from dev.djctavia to DjCtavia
    • This changes the mod folder location (see Migration Guide below)
  • InventoryManagerAPIPlugin: Now uses switch expression to instantiate the appropriate storage backend based on configuration

Fixed

  • Simplified success message format in InventorySaveCommand

Migration Guide (1.0.0 to 1.1.0)

Mod Folder Location Change

The mod data folder has changed due to the manifest Group update to follow Hytale naming conventions:

Before (1.0.0) After (1.1.0)
mods/dev.djctavia.InventoryManagerAPI/ mods/DjCtavia.InventoryManagerAPI/

Inventory Data Migration

If you have existing inventory JSON files, you need to transfer them manually:

  1. Locate your old data folder:

    <HytaleServer>/mods/dev.djctavia.InventoryManagerAPI/inventories/
    
  2. Copy all .json files to the new location:

    <HytaleServer>/mods/DjCtavia.InventoryManagerAPI/inventories/
    
  3. Optionally delete the old folder after confirming the migration was successful.

Configuration File

Your configuration file will also be in a new location. You may need to reconfigure your settings:

  • Old path: mods/dev.djctavia.InventoryManagerAPI/InventoryManagerAPI.json
  • New path: mods/DjCtavia.InventoryManagerAPI/InventoryManagerAPI.json

New Configuration Options

The configuration file now supports additional options:

{
    "StorageDirectory": "...",
    "ClearInventoryOnSave": true,
    "DeleteFileOnLoad": true,
    "StorageType": "Json",
    "PostgreSQL": {
        "Host": "localhost",
        "Port": 5432,
        "Database": "postgres",
        "Username": "postgres",
        "Password": "",
        "TableName": "inventories"
    }
}

To use PostgreSQL storage instead of JSON files, change "StorageType": "Json" to "StorageType": "PostgreSQL" and configure your database connection settings.