I uploaded the mod and nothing happened.

Hello
Problem 1
the mod uploaded automatic
 

CSharp] Started Oxide.Compiler v successfully
RandomItems was compiled successfully in 1359ms
[Random Items] Could not read configuration, creating new config file
[Random Items] Item list auto-refreshed from game definitions. Missing items have been added.
Loaded plugin Random Items v2.2.0 by Drxp

then I upload it manually:
 

o.load RandomItems
Shutting down compiler because idle shutdown
Compiler shutdown completed

I try to jump and do not get anything

Question 2
What are the commands to take control of the mod itself? How to manage it? I would appreciate help

Thanks

Problem 1 – “Jump” gives nothing

On first start the plugin created oxide/config/RandomItems.json with its default settings.
By default the option
"Give Item On Jump": false
is set to false, so nothing happens when you jump.
Either wait for the normal timed drop (every 300 s by default) or turn the jump feature on:
Open oxide/config/RandomItems.json.
Set  "Give Item On Jump": true

Save the file and reload the plugin:

oxide.reload RandomItems  (or o.reload RandomItems)
After that, every valid jump (not on cooldown) will hand out an item.

Problem 2 – How to manage / control the plugin
A. Console command supplied by the plugin

updatestacksize

Usage:

updatestacksize  → lists all item categories in the config

updatestacksize <category> <newSize> → sets stack size for every item in that category

Must be run from the server console (not in-game chat).

B. Configuration file options (oxide/config/RandomItems.json)

Interval Seconds – time between automatic drops.

Hardcore Mode – true = block resource gathering.

Debug Mode – verbose logging.

Happy Hour Enabled / StartTime / EndTime – limit drops to a daily time window and announce start/end.

Give Item On Jump – true = disable timer, give item whenever a player jumps.

items [] – full list of items, categories, stack sizes (auto-generated the first run; you can edit or remove entries).

Hey, thanks, I read and thought about it a bit

1. I'm looking for the plugin to adjust itself according to a percentage or something like that of the server's stack size

The easiest way to adjust this is by "categories" and not by item (because it's time-consuming and labor-intensive)

Is it possible to set a minimum and maximum amount by stack size in percentages, by categories?

That is, to give, say, a minimum of 25 percent of the stack size to 75 percent of the stack size in a certain category (this is important because if there are new ammunition and rockets and it gives the same amount, it will throw the game completely out of balance)

2.
I notice that "updatestacksize" simply lists which categories there are, but regarding "updatestacksize <category> <newSize>"

What do you mean by newSize, what value should I write here? Is it by percentage? Where is the minimum amount?

3.
"Interval Seconds – time between automatic drops."

What do you mean by automatic drop, is it every few seconds the player receives a random item in seconds? (Because I'm not interested in that, just by jumps)

4. "
Hardcore Mode – true = block resource gathering." Meaning you can't gather and create resources from quarrying rocks, chopping wood, and all that?

5. "Happy Hour Enabled / StartTime / EndTime – limit drops to a daily time window and announce start/end.

"
This is about receiving items by a fixed time and not by jumps, right?

6.
I want every time the player jumps, to receive an item, even if he is in a structure and on a box and his jump is short, to still receive an item, how can I do that?

7.
How can I remove the message that the player receives after each item receipt?

Thanks

Hi! Thanks for your detailed questions and feedback. Here are answers to each of your points:

1. Stack Size by Category as Percentage (Min/Max)

Currently, the plugin sets stack sizes per item or per category using a fixed number, not a percentage.

To achieve what you want (e.g., give between 25% and 75% of the server’s max stack size for a category), the plugin would need to be updated to support min/max percentages per category.

This would allow you to define, for example, that all "ammo" items are given in random amounts between 25% and 75% of their max stack size, keeping things balanced even as new items are added.

If you want this feature, let me know! It’s a great idea and can be added.

2. updatestacksize <category> <newSize> Command

The <newSize> is a fixed number, not a percentage. For example, updatestacksize ammo 30 sets all "ammo" items to a stack size of 30.

There is currently no minimum/maximum or percentage option just a single value.

If you want to set by percentage or set min/max, that would require a plugin update (see point 1).

3. "Interval Seconds" – What is an Automatic Drop?

"Automatic drop" means the plugin gives every online player a random item every X seconds (as set by "Interval Seconds").

If you only want items to be given when players jump (not automatically), set "Give Item On Jump": true in the config. This disables the timer-based drops.

4. "Hardcore Mode" – What Does It Block?

When "Hardcore Mode" is enabled, players cannot gather resources from dispensers (e.g., mining rocks, chopping trees, etc.).

This is to make the game harder by forcing players to rely on random item drops.

5. "Happy Hour" – How Does It Work?

"Happy Hour" limits automatic drops to a specific daily time window and announces when it starts/ends.

If you use "Give Item On Jump," Happy Hour does not affect jump-based drops only the timer-based (automatic) ones.

6. Jump Detection – Even for Short Jumps

The plugin already gives an item whenever a player jumps, regardless of how high or where (even on boxes or inside structures).

If you notice missed jumps, let me know there may be edge cases, but the intent is to reward every jump.

7. Removing the Item Receipt Message

To remove the chat message players get after receiving an item, you’ll need to comment out or remove the line in the code that sends the message.

Specifically, look for lines like:

player.ChatMessage($"<b><color=yellow>Random</color><color=red>Items</color></b>: {message}");

and either comment them out or delete them.

If you want, I can provide a code snippet or update to do this for you.

Let me know if you want help with any of these changes, especially the percentage-based stack sizes or removing messages!

Thanks for using the plugin and for your suggestions they help make it better for everyone.

Changed Status from Pending to Not a Bug

1. "This would allow you to define, for example, that all "ammo" items are given in random amounts between 25% and 75% of their max stack size, keeping things balanced even as new items are added."

I would be very happy to define a maximum quantity of a category (say, in 128 ammo - it can give 128 5.56 rounds and 128 missiles, so it is impossible to use this)

2. "The <newSize> is a fixed number, not a percentage. For example, updatestacksize ammo 30 sets all "ammo" items to a stack size of 30."

So when the mod gives 5.56 rounds, will it only give 30 (according to the definition, the example you gave)? Or a random number from 1-30?

6. "Jump Detection – Even for Short Jumps"

I notice that there are some glitches, for example when the player presses jump, it sometimes misses (a normal jump). And there are also glitches if let's say I'm building a base, and there's a roof above me, there's a box and I jump, so my jumps are shorter, meaning the jumps are faster, and I saw that it doesn't work properly and brings items (probably cooldown) I'd be happy to check it out

7. "Removing the Item Receipt Message" I would love to have an option for the admin to be able to cancel it by command, I understand that it can be deleted.

In addition, as I wrote, I would love for you to do what I suggested about the stacksize, which will also be adapted to the famous plugin in umod, I would really love for all these changes to be made very soon

Thank you very much for the generous response

i will get this updated and pushed out asap!