Easy, fully configurable and customizable custom items for your SCP:SL Server!

• About
• Features
• Requirements
• Installation
• Quick Start
• Documentation
• Support
• Contributing
• Donate
• Contact

UncomplicatedCustomItems (UCI) is a powerful LabAPI and Exiled plugin that enables server administrators to create fully customizable items for SCP: Secret Laboratory servers using simple YAML configuration files. Whether you want to modify existing items or create entirely new ones, UCI provides an intuitive and flexible solution.

• Unlimited Custom Items: Create as many custom items as your server needs
• YAML Configuration: Easy-to-use configuration files separate from LabApi's default config
• Comprehensive Customization: Configure item properties, damage values, descriptions, and behaviors
• In-Game Commands: Manage your custom items directly from the server console or RA menu
• Active Community: Join our Discord server for support and exclusive previews
• Special Perks: Verified server owners get access to special privileges and early features

• LabApi >= v1.2.0 or Exiled >= v9.9.2

1. Download the UncomplicatedCustomItems-LabApi.dll from our releases page
2. Place the file in your server's LabApi/Port/Plugins directory
3. Restart your server
4. Configure your custom items in the generated configuration files

1. Download the UncomplicatedCustomItems-Exiled.dll from our releases page
2. Place the file in your server's Exiled/Plugins directory
3. Restart your server
4. Configure your custom items in the generated configuration files

After installation, UCI will generate default configuration files in your server's config directory. Here's a basic example of creating a custom item:

# Sets the ID of the custom item. Custom items cannot share IDs. id: 2 # Sets the name of the custom item. name: FunnyGun # Sets the description of the custom item. This is shown as part of a hint when the item is equipped or picked up. description: A weapon that has a shotgun-like bullet spread # The extended description of the custom item. Used by the `.customiteminfo` command extended_description: '' # Sets the badge name of the custom item. Remove the text in quotes to disable it. badge_name: FunnyGun # Sets the badge color of the custom item. badge_color: pumpkin # Sets the weight of the custom item. This affects movement speed when equipped. weight: 2 # Sets the item the custom item will use. item: GunFRMG0 # Sets the scale of the custom item when dropped. scale: x: 1 y: 1 z: 1 # Defines the spawn settings for the custom item. Information on rooms can be found in the UCI Information forum on Discord. spawn: # If true, the custom item can spawn. If false, it will not. do_spawn: true # The number of custom items to spawn. count: 1 spawn_settings: - chance: 30 rotation: x: 0 y: 0 z: 0 w: 0 # The room(s) where the custom item can spawn. dynamic_spawn: - room: Lcz914 coords: x: 1 y: 1 z: 1 # Sets the custom flags of the custom item. Information about custom flags can be found in the UCI Information forum on Discord. custom_flags: InfiniteAmmo, ItemGlow, DistruptorTracer # Settings for the CustomFlags. You can remove any unused settings. flag_settings: [] arguments: OnShotWeapon: action Example OnAimedWeapon: Player::Damage(10, "Test", 'AIMING') # Sets the custom data type the item will use. custom_item_type: Weapon # Specifies the modifications the custom item will have. custom_data: damage: 2.75 max_ammo: 150 max_magazine_ammo: 150 max_barrel_ammo: 100 penetration: 1.24000001 inaccuracy: 1.24000001 aiming_inaccuracy: 1.24000001 damage_falloff_distance: 1 attachments: DotScope enable_friendly_fire: false

For detailed configuration options and examples, check our documentation.

Visit the UCI Wiki for comprehensive guides, examples, and API documentation.

1. Generate Logs: Run ucilogs in your server console
2. Report the Issue: Post the log ID in our Bug Report Forum
3. Include Details: Please provide steps to reproduce the issue

Join our Discord server for:

• General support and troubleshooting
• Feature requests and suggestions
• Community discussions
• Early access to new features (verified servers)

We welcome contributions! Please feel free to:

• Submit bug reports and feature requests
• Create pull requests for improvements
• Help improve documentation
• Share your custom item configurations with the community

All UncomplicatedCustomServer plugins are free and open-source. If you find our work valuable, please consider supporting us:

Your donations help us maintain and improve our plugins for the entire SCP:SL community.

• FoxWorn3365

  • Discord: @foxworn
  • Email: foxworn3365@gmail.com

• Dr.Agenda

  • Discord: @dr.agenda

• Mr. Baguetter

  • Discord: @ender1992
  • Email: baguetter@thaumielscpsl.site

• Discord Server: https://discord.gg/5StRGu8EJV