Skip to content

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Money Time Fixed

A maintained Rust server plugin for Oxide/uMod that rewards active players through Economics or Server Rewards.

This repository is based on Money Time by Wulf, which in turn credits Spiritwind for the original Lua plugin. The fork preserves the familiar playtime-reward concept while correcting payout, timing, permission, and data-handling problems.

Features

  • Scheduled rewards for connected players
  • Economics or Server Rewards currency
  • Optional AFK filtering through AFK API
  • One-time welcome bonuses
  • Optional survival-time bonuses
  • Permission-based payout multipliers
  • Immediate multiplier updates when permissions or group membership change
  • Pending reward recovery when a currency provider is temporarily unavailable
  • Configuration validation and migration from the legacy 2.3.x format
  • Optional player notifications and new-save data resets

Requirements

Install one currency provider:

AFK API is optional and is only used when its configuration setting is enabled.

Installation

  1. Download MoneyTime.cs.
  2. Place it in oxide/plugins.
  3. Allow the plugin to generate a fresh configuration.
  4. Select the installed currency provider in oxide/config/MoneyTime.json.
  5. Grant any multiplier or administration permissions you want to use.

For a clean test, unload the plugin and back up or remove the old configuration and data files before installing:

  • oxide/config/MoneyTime.json
  • oxide/data/MoneyTime.json

Default configuration

{
  "Currency provider (Economics or ServerRewards)": "Economics",
  "Enable AFK API plugin support": false,
  "Base payout amount": 100.0,
  "Payout interval (seconds)": 600,
  "Time alive bonus": false,
  "Time alive multiplier": 0.0,
  "Allow permission-based multipliers to stack": false,
  "Stacked multiplier mode (Additive or Multiplicative)": "Additive",
  "New player welcome bonus": 500.0,
  "Notify players of successful payouts": true,
  "Notify players of missed AFK payouts": true,
  "Reset player data on a new save": false,
  "Permission-based multipliers": {
    "donor": 2.5,
    "vip": 5.0
  }
}

Currency provider

Set Currency provider (Economics or ServerRewards) to exactly one of:

  • Economics
  • ServerRewards

Server Rewards only accepts whole points. Decimal payouts are rounded to the nearest whole point.

Permission multipliers

Each configured entry creates a permission using the moneytime.<name> format:

  • moneytime.donor — 2.5x with the default configuration
  • moneytime.vip — 5x with the default configuration

When stacking is disabled, the highest multiplier wins.

When stacking is enabled:

  • Additive adds the configured multiplier values. The default donor and VIP permissions produce 7.5x.
  • Multiplicative multiplies them. The same permissions produce 12.5x.

Permission and group membership changes are applied to connected players without reloading the plugin.

Time-alive bonus

When enabled, the bonus is calculated when the player dies:

(seconds alive / payout interval) × base payout × time-alive multiplier

Only the current online lifetime is counted. Offline time and server downtime are excluded. If the currency provider is unavailable, the calculated bonus is saved and retried later.

Welcome bonus

A welcome bonus is recorded as received only after the configured currency provider confirms the transaction. Failed bonuses remain eligible and are retried while the player is connected.

Existing 2.3.x data remains readable. Because the upstream version incorrectly marked some unpaid players as already paid, administrators can selectively reset welcome eligibility.

Permissions

  • moneytime.admin — permits use of administrative commands
  • moneytime.<configured-name> — applies the corresponding payout multiplier

Examples:

oxide.grant group vip moneytime.vip
oxide.grant user 7656119XXXXXXXXXX moneytime.admin

Commands

Available from the server console or in-game chat:

moneytime status
moneytime resetwelcome <Steam ID>
moneytime resetwelcome all

Use /moneytime when entering the command in chat.

Updating from 2.3.x

Version 2.4.0 can migrate the legacy currency toggles and the misspelled Permission-based mulitipliers key. The normalized configuration is saved automatically.

Back up the existing configuration and data files before updating. Review the generated configuration afterward because the two legacy currency booleans have been replaced with a single provider setting.

Credits

  • Spiritwind — original Money Time Lua plugin
  • Wulf — original C# implementation and maintenance
  • SeesAll — fixes and 2.4.0 maintenance release

See CHANGELOG.md for release details.

License

MIT. The original and modification copyright notices are retained in LICENSE.

About

This repository contains a fixed version of the MoneyTime plugin originally created by Wulf for Oxide/uMod

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages