?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
SimpleCustomItems

SimpleCustomItems

This plugin allows you to easily create and manage custom items.

323
4

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

75% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Links

Join Discord server

Creators

Losterixx
Losterixx Member

Details

Licensed ARR
Published 6 months ago
Updated 2 weeks ago

This plugin allows you to easily create and manage custom items.

Note: This plugin utilizes MiniMessage for color codes and formatting. For example, you need to use "/ci name <red>Test" instead of "/ci name &cTest". For more information on MiniMessage, visit: https://docs.advntr.dev/minimessage/format.html

Features

  • Rename items with unique names.
  • Rename items with unique displaynames.
  • Add customizable lore lines to items.
  • Apply/Remove various enchantments at all levels.
  • Apply/Remove various itemflags.
  • Set items as unbreakable.
  • Set items hidetooltip.
  • [NEW] Set items maximal stack-size.
  • Set items amount.
  • Set items CustomModelData.
  • Use MiniMessage for advanced text formatting.
  • Simple commands for easy item management.
  • Customizable plugin messages.
  • [NEW] Use the storagesystem to save your custom items. (Note: This feature is still experimental)

Commands

  • Use /simplecustomitems reload to reload the plugin.
  • Use /simplecustomitems about to get information about the plugin.
  • Use /ci name <name> to change the item name.
  • Use /ci displayname <displayname> to change the item displayname.
  • Use /ci lore <add/remove/set/clear> <line/text> to edit the item lore.
  • Use /ci maxstacksize <amount> to set the items maximal stack-size.
  • Use /ci amount <amount> to set the item amount.
  • Use /ci custommodeldata <custommodeldata> to set the item custommodeldata.
  • Use /ci enchant <enchantment> <level> to add an enchantment to the item.
  • Use /ci rmenchant <enchantment> to remove an enchantment from the item.
  • Use /ci unbreakable <true/false> to toggle item unbreakability.
  • Use /ci hidetooltip <true/false> to toggle item unbreakability.
  • Use /ci addflag <itemflag> to add an itemflag to the item.
  • Use /ci rmflag <itemflag> to remove an itemflag from the item.
  • Use /cistorage gui to open the storage menu.
  • Use /cistorage addItem to add a item to the storagesystem.
  • Use /cistorage size to check the filesize of 'data.yml'.

Permissions

  • simplecustomitems.admin.about - Allows you to use /sci about.
  • simplecustomitems.admin.reload - Allows you to use /sci reload.
  • simplecustomitems.admin.help - Allows you to use /sci help.
  • simplecustomitems.admin.storage - Allows you to use the storagesystem.
  • simplecustomitems.use - Allows you to use the /ci & /ci help command.
  • simplecustomitems.name - Allows you to use /ci name.
  • simplecustomitems.displayname - Allows you to use /ci displayname.
  • simplecustomitems.lore - Allows you to use /ci lore.
  • simplecustomitems.maxstacksize - Allows you to use the /ci maxstacksize command.
  • simplecustomitems.amount - Allows you to use the /ci amount command.
  • simplecustomitems.custommodeldata - Allows you to use the /ci custommodeldata command.
  • simplecustomitems.enchant - Allows you to use /ci enchant.
  • simplecustomitems.rmenchant - Allows you to use /ci rmenchant.
  • simplecustomitems.unbreakable - Allows you to use /ci unbreakable.
  • simplecustomitems.hidetooltip - Allows you to use /ci hidetooltip.
  • simplecustomitems.addflag - Allows you to use /ci addflag.
  • simplecustomitems.rmflag - Allows you to use /ci rmflag.

Configs

View config.yml 
# This plugin utilizes MiniMessage for messages.
# For more information, visit https://docs.adventure.kyori.net/minimessage.html

file-version: 1

# The prefix before every message
prefix: "<#D69BF5><b>SCI</b> <dark_gray>âš¡ <gray>"

# The messages file to use
langFile: 'english'

# Settings for the guis
guis:
  # Id of the gui (!: Do NOT edit this.)
  storage:
    # Title of the storage gui
    title: "<#D69BF5><b>SCI</b> <dark_gray>âš¡ <light_purple><b>Storage</b>"
    # Size of the storage gui (in rows | 1 - 5)
    rows: 5
    # These settings will be applied to all stored items inside the gui
    item-settings:
      # This lore will be placed under the item-lore
      lore:
        - " "
        - "<dark_gray> 🢒 <dark_gray>[<gray>Leftclick<dark_gray>] <gray>Clone item from storage"
        - "<dark_gray> 🢒 <dark_gray>[<gray>Drop<dark_gray>] <gray>Delete item from storage"
    # The row on the button of the gui
    bottom-row:
      # Id of the item (!: Do NOT edit this.)
      close:
        # Type of the item
        type: BARRIER
        # Name of the item
        name: "<red>Close"
        # Lore of the item
        lore:
          - "<dark_gray> 🢒 <gray>Click here to close the gui."
        # Slot of the item in the bottom-row (1-9)
        slot: 5
      next:
        type: ARROW
        name: "<gray>Next page <dark_gray>(%page%)"
        lore:
          - "<dark_gray> 🢒 <gray>Click to switch page."
        slot: 7
      previous:
        type: ARROW
        name: "<gray>Previous page <dark_gray>(%page%)"
        lore:
          - "<dark_gray> 🢒 <gray>Click to switch page."
        slot: 3
View english.yml 
# This plugin utilizes MiniMessage for messages.
# For more information, visit https://docs.adventure.kyori.net/minimessage.html

file-version: 1

# General messages
general:
  noPlayer: "<gray>You <red>must be a player<gray> to execute this command!"
  noPerms: "<gray>You <red>do not have permission<gray> to execute this command!"

# Command messages
commands:
  # Messages for the /simplecustomitems command (main plugin command)
  simplecustomitems:
    usage: "<gray>Please use <red>/simplecustomitems <about/reload/help><gray>!"
    about: "<gray>SimpleCustomItems v%version% <dark_gray>- <gray>%author%"
    reload:
      reloading: "<yellow>Reloading <gray>SimpleCustomItems..."
      reloaded: "<green>Successfully reloaded <gray>SimpleCustomItems! <dark_gray>(%time%ms)"
      error: "<gray>An <red>error occurred <gray>while reloading SimpleCustomItems! Check the console for details."
    help:
      - "%prefix% "
      - "%prefix% <white>Command help:"
      - "%prefix% "
      - "%prefix% <dark_gray>- <#DEC194> /simplecustomitems about <dark_gray>- <gray>View the plugin information"
      - "%prefix% <dark_gray>- <#DEC194> /simplecustomitems reload <dark_gray>- <gray>Reload the plugin"
      - "%prefix% <dark_gray>- <#DEC194> /simplecustomitems help <dark_gray>- <gray>View this message"
      - "%prefix% <dark_gray>- <#DEC194> /customitem help <dark_gray>- <gray>View help for the /customitem command"
      - "%prefix% "
  # Messages for the /sci command
  customitems:
    usage:
      - "%prefix%"
      - "%prefix%<gray>Use <red>/customitems <option> <value> <gray>to customize your item."
      - "%prefix%"
      - "%prefix%<gray>Available subcommands:"
      - "%prefix%<dark_gray>- <#DEC194>/citem name <name> <dark_gray>- <gray>Change the name of the item"
      - "%prefix%<dark_gray>- <#DEC194>/citem displayname <name> <dark_gray>- <gray>Change the display name of the item"
      - "%prefix%<dark_gray>- <#DEC194>/citem lore <add/remove/set/clear> <text> <dark_gray>- <gray>Manage item lore"
      - "%prefix%<dark_gray>- <#DEC194>/citem enchant <enchantment> <level> <dark_gray>- <gray>Enchant the item"
      - "%prefix%<dark_gray>- <#DEC194>/citem rmenchant <enchantment> <dark_gray>- <gray>Remove an enchantment from the item"
      - "%prefix%<dark_gray>- <#DEC194>/citem addflag <flag> <dark_gray>- <gray>Add a flag to the item"
      - "%prefix%<dark_gray>- <#DEC194>/citem rmflag <flag> <dark_gray>- <gray>Remove a flag from the item"
      - "%prefix%<dark_gray>- <#DEC194>/citem unbreakable <true/false> <dark_gray>- <gray>Set the item unbreakable"
      - "%prefix%<dark_gray>- <#DEC194>/citem hidetooltip <true/false> <dark_gray>- <gray>Hide the item tooltip"
      - "%prefix%<dark_gray>- <#DEC194>/citem amount <number> <dark_gray>- <gray>Set the amount of the item"
      - "%prefix%<dark_gray>- <#DEC194>/citem custommodeldata <number> <dark_gray>- <gray>Set custom model data"
      - "%prefix%<dark_gray>- <#DEC194>/citem maxstacksize <number> <dark_gray>- <gray>Set the maxstacksize of the item"
      - "%prefix%"
    no-item: "<gray>You <red>must be holding an item <gray>to use this command!"
    name:
      success: "<gray>Item name <green>successfully changed<gray>!"
    displayname:
      success: "<gray>Item display name <green>successfully changed<gray>!"
    lore:
      added-msg: "<gray>Lore line <green>added <gray>to the item!"
      removed-msg: "<gray>Lore line <yellow>removed <gray>from the item!"
      set-msg: "<gray>Lore line <green>successfully set<gray>!"
      cleared-msg: "<gray>Item lore <yellow>cleared<gray>!"
      error:
        line-not-found: "<gray>Line <gray>not found <gray>in lore!"
        invalid-number: "<red>Invalid number! <gray>Please provide a valid line number!"
    enchant:
      error:
        invalid: "<red>Invalid enchantment name<gray>!"
        level: "<red>Invalid level! <gray>Please provide a level <red>between 1 and 255<gray>."
      success: "<gray>Item <green>successfully enchanted<gray>!"
    rmenchant:
      error:
        invalid: "<red>Invalid enchantment name <gray>for removal!"
      success: "<gray>Enchantment <green>successfully removed<gray>!"
    addflag:
      error:
        invalid: "<red>Invalid flag name! <gray>Please provide a valid item flag."
      success: "<gray>Flag <green>successfully added <gray>to the item!"
    rmflag:
      error:
        invalid: "<red>Invalid flag name! <gray>Please provide a valid item flag."
      success: "<gray>Flag <green>successfully removed <gray>from the item!"
    unbreakable:
      success: "<gray>Item unbreakable status set to <white>%value%<gray>!"
    hidetooltip:
      success: "<gray>Item tooltip visibility set to <white>%value%<gray>!"
    amount:
      error: "<red>Invalid amount! <gray>Please provide a valid amount <red>between 1 and the maxstacksize<gray>."
      success: "<gray>Item amount set to <white>%amount%<gray>!"
    custommodeldata:
      error: "<red>Invalid CustomModelData! <gray>Please provide a number <red>between 1 and 1,000,000,000<gray>."
      success: "<gray>CustomModelData set to <white>%amount%<gray>!"
    maxstacksize:
      error: "<red>Invalid MaxStacksize! <gray>Please provide a number <red>between 1 and 99<gray>."
      success: "<gray>MaxStacksize set to <white>%amount%<gray>!"
  # Messages for the /storage command
  storage:
    usage: "<gray>Please use <red>/storage <gui/addItem/size><gray>!"
    no-item: "<gray>You need to <red>hold an item<gray>!"
    no-items: "<gray>There are <red>no items in the storage-system<gray>!"
    item-added: "<gray>The item <green>has been added<gray>! The new size of the datafile is now: <white>%datafile_size%"
    info-size: "<gray>The current size of the datafile is <white>%datafile_size%<gray>!"
View german.yml 
# Dieses Plugin verwendet MiniMessage für Nachrichten.
# Weitere Informationen findest du unter https://docs.adventure.kyori.net/minimessage.html

file-version: 1

# Generelle Nachrichten
general:
  noPlayer: "<gray>Dies können <red>nur Spieler<gray> ausführen!"
  noPerms: "<gray>Du hast <red>keine Berechtigung<gray> für diesen Befehl!"

# Befehlsnachrichten
commands:
  # Nachrichten für den /simplecustomitems Befehl (Hauptbefehl des Plugins)
  simplecustomitems:
    usage: "<gray>Bitte nutze <red>/simplecustomitems <about/reload/help><gray>!"
    about: "<gray>SimpleCustomItems v%version% <dark_gray>- <gray>%author%"
    reload:
      reloading: "<yellow>SimpleCustomItems <gray>wird neugeladen<gray>..."
      reloaded: "<green>SimpleCustomItems wurde <gray>erfolgreich neugeladen! <dark_gray>(%time%ms)"
      error: "<gray>Ein <red>Fehler ist aufgetreten<gray> beim Neuladen von SimpleCustomItems! Überprüfe die Konsole für Details."
    help:
      - "%prefix% "
      - "%prefix% <white>Befehlsübersicht:"
      - "%prefix% "
      - "%prefix% <dark_gray>- <#DEC194> /simplecustomitems about <dark_gray>- <gray>Zeigt Plugin-Informationen"
      - "%prefix% <dark_gray>- <#DEC194> /simplecustomitems reload <dark_gray>- <gray>Läd das Plugin neu"
      - "%prefix% <dark_gray>- <#DEC194> /simplecustomitems help <dark_gray>- <gray>Sendet diese Nachricht"
      - "%prefix% <dark_gray>- <#DEC194> /customitem help <dark_gray>- <gray>Sendet die Hilfe für den /customitem Befehl"
      - "%prefix% "
  # Nachrichten für den /sci Befehl
  customitems:
    usage:
      - "%prefix%"
      - "%prefix%<gray>Nutze <red>/customitems <name> <wert> <gray>um dein Item anzupassen."
      - "%prefix%"
      - "%prefix%<gray>Verfügbare Unterbefehle:"
      - "%prefix%<dark_gray>- <#DEC194>/citem name <Name> <dark_gray>- <gray>Ändert den Namen des Items"
      - "%prefix%<dark_gray>- <#DEC194>/citem displayname <Name> <dark_gray>- <gray>Ändert den Anzeigenamen des Items"
      - "%prefix%<dark_gray>- <#DEC194>/citem lore <add/remove/set/clear> <text> <dark_gray>- <gray>Verwalte die Lore des Items"
      - "%prefix%<dark_gray>- <#DEC194>/citem enchant <Verzauberung> <level> <dark_gray>- <gray>Verzaubert das Item"
      - "%prefix%<dark_gray>- <#DEC194>/citem rmenchant <Verzauberung> <dark_gray>- <gray>Entfernt eine Verzauberung vom Item"
      - "%prefix%<dark_gray>- <#DEC194>/citem addflag <Flag> <dark_gray>- <gray>Fügt dem Item eine Flagge hinzu"
      - "%prefix%<dark_gray>- <#DEC194>/citem rmflag <Flag> <dark_gray>- <gray>Entfernt eine Flagge vom Item"
      - "%prefix%<dark_gray>- <#DEC194>/citem unbreakable <true/false> <dark_gray>- <gray>Setzt das Item unzerstörbar"
      - "%prefix%<dark_gray>- <#DEC194>/citem hidetooltip <true/false> <dark_gray>- <gray>Versteckt den Tooltip des Items"
      - "%prefix%<dark_gray>- <#DEC194>/citem amount <Anzahl> <dark_gray>- <gray>Setzt die Anzahl des Items"
      - "%prefix%<dark_gray>- <#DEC194>/citem custommodeldata <Zahl> <dark_gray>- <gray>Setzt die CustomModelData des Items"
      - "%prefix%<dark_gray>- <#DEC194>/citem maxstacksize <Zahl> <dark_gray>- <gray>Setzt die maximale Stapelgröße des Items"
      - "%prefix%"
    no-item: "<gray>Du musst <red>ein Item in der Hand halten<gray>, um diesen Befehl zu benutzen!"
    name:
      success: "<gray>Der Name des Items wurde <green>erfolgreich geändert<gray>!"
    displayname:
      success: "<gra<>Der Anzeigename des Items wurde <green>erfolgreich geändert<gray>!"
    lore:
      added-msg: "<gray>Lore-Zeile wurde dem Item <green>hinzugefügt<gray>!"
      removed-msg: "<gray>Lore-Zeile wurde vom Item <yellow>entfernt<gray>!"
      set-msg: "<gray>Die Lore-Zeile wurde erfolgreich <green>gesetzt<gray>!"
      cleared-msg: "<gray>Die Lore des Items wurde <yellow>gelöscht<gray>!"
      error:
        line-not-found: "<gray>Zeile in der Lore <red>nicht gefunden<gray>!"
        invalid-number: "<red>Ungültige Zahl! <gray>Bitte gib eine gültige Zeilennummer an!"
    enchant:
      error:
        invalid: "<red>Ungültiger Verzauberungsname!"
        level: "<red>Ungültiges Level! <gray>Bitte gib ein Level <red>zwischen 1 und 255 <gray>an."
      success: "<gray>Das Item wurde <green>erfolgreich verzaubert<gray>!"
    rmenchant:
      error:
        invalid: "<red>Ungültiger Verzauberungsname <gray>zur Entfernung!"
      success: "<gray>Verzauberung wurde <green>erfolgreich entfernt<gray>!"
    addflag:
      error:
        invalid: "<red>Ungültiger Flag-name! <gray>Bitte gib eine gültige Item-Flagge an."
      success: "<gray>Flagge wurde <green>erfolgreich <gray>zum Item <green>hinzugefügt<gray>!"
    rmflag:
      error:
        invalid: "<red>Ungültiger Flaggenname! <gray>Bitte gib eine gültige Item-Flagge an."
      success: "<gray>Flagge wurde <green>erfolgreich <gray>vom Item <green>entfernt<gray>!"
    unbreakable:
      success: "<gray>Der Unzerstörbarkeitsstatus des Items wurde auf <white>%value% <gray>gesetzt!"
    hidetooltip:
      success: "<gray>Die Tooltip-Sichtbarkeit des Items wurde auf <white>%value% <gray>gesetzt!"
    amount:
      error: "<red>Ungültige Anzahl! <gray>Bitte gib eine gültige Anzahl <red>zwischen 1 und der maximalen Stapelgröße des Items <gray>an."
      success: "<gray>Die Anzahl des Items wurde auf <white>%amount% <gray>gesetzt!"
    custommodeldata:
      error: "<red>Ungültige CustomModelData! <gray>Bitte gib eine Zahl <red>zwischen 1 und 1.000.000.000 <gray>an."
      success: "<gray>CustomModelData wurde auf <white>%amount% <gray>gesetzt!"
    maxstacksize:
      error: "<red>Ungültige Maximal-Stapelgröße! <gray>Bitte gib eine Zahl <red>zwischen 1 und 99<gray>an."
      success: "<gray>Die maximale Stapelgröße wurde auf <white>%amount% <gray>gesetzt!"
  # Messages for the /storage command
  storage:
    usage: "<gray>Bitte benutze <red>/storage <gui/addItem/gui><gray>!"
    no-item: "<gray>Du musst <red>ein Item in der Hand halten<gray>, um diesen Befehl zu benutzen!"
    no-items: "<gray>Es sind <red>keine Items in der Storage-Datei<gray>!"
    item-added: "<gray>Item <green>erfolgreich <gray>zur Storage-Datei <green>hinzugefügt<gray>! Die Storage-Datei ist nun <white>%datafile_size% <gray>groß!"
    info-size: "<gray>Die aktuelle Größe der Storage-Datei beträgt derzeit <white>%datafile_size%<gray>!"

Contact

If you encounter any issues or bugs, or have a request for a new feature, please contact me via Discord or join my Discord-Server.

My discord-name is Losterixx.

My Discord-Server: Link