Search the Community

A webhosting always required. This website is for developers to manage their licenses It doesn't automatically license your plugins, but it talks about how to license it in the documentation. The system works with the IP address of the server where the plugin will run, not with the license key. Documentation content Already Licensed A Sample Plugin Information on how to license a plugin Information about api returns

Introduction CustomRewards is a turnkey solution to reward player engagement. This plugin allows you to give a player any type of reward based on conditions you'll be able to configure. Whether you're a server admin aiming to boost player engagement or a developer creating complex reward systems, CustomRewards is your go-to solution. Main Features: Diversity of Rewards: Set up a huge variety of rewards for your players, ranging from items to special permissions, including server command execution. Reward Templates: Create different reward models for various events or scenarios, providing maximum flexibility to meet your server's needs. Award Conditions: Ensure only eligible players receive certain rewards by setting conditions based on groups, permissions, and more. Integration with Other Plugins: CustomRewards isn't just a standalone, it can also be seamlessly integrated with other externals plugins such as VoteSystem or PlaytimeTracker : Vote System : By using Custom Reward with VoteSystem, your players will be able to obtain rewards by voting. PlayTime Reward (free) : By using CustomRewards with PlaytimeTracker, your players will be able to obtain rewards based on their playtime. Interface Customization Provide your players with an appealing visual experience with a fully customizable user interface, custom reward images, and colorful themes. Expandability for Developers For those looking to delve deeper, CustomRewards offers a robust API, allowing you to integrate your own point system or even other plugins ! Plugin's Future: We always listen to the community! If you have a specific plugin you'd like to see integrated with CustomRewards, please let us know. Our goal is to make CustomRewards as versatile and useful as possible for all users. Support : I am very often available and will respond as quickly as possible to all your questions, here or on my Discord: https://discord.gg/JJnxFgP27G. Full Documentation : Feel free to check out the complete documentation here. Commands (chat) : - /CustomRewards_Give <type> <player name or id> <quantity> : available only for administrators or with permission CustomRewards.Admin - The commands to show the UI need to be implemented in the configuration. Permissions : - CustomRewards.Admin : enable admin commands if not administrator - CustomRewards.<Type>.Use : Permission linked to the type (rewards template), users without the permission will not be able to use the command to display the UI. Therefore, it's important to add the permission to your groups once the template is created! How To use API : private void Give_API(string rewardType, ulong playerId, int quantity) // Add quantity points for player (for referenced rewardType) private int Get_API(string rewardType, ulong playerId) // Get quantity points for player (for referenced rewardType) CustomRewards Configuration Tutorial Step 1: Initial Setup : - Ensure the CustomRewards_rewards folder is present in Oxide/Data. If not, the plugin will attempt to create it automatically, but it's good to check. - Ensure - For each reward type you want to configure, create a .json file in the CustomRewards_rewards folder. For instance, for a reward type called "VIP", you might have a VIP.json file. Step 2: Basic Configuration In your .json file: - "Enabled": Set this value to true to activate this reward type. - "Commands for show UI": List of commands that will display the user interface for this reward type. For example: ["rewards_vip", "vip_rewards"]. Step 3: User Interface Configuration Under "UI Settings": - Configure the appearance and layout of the user interface with properties like "Max Reward By Page", "Window Rect", etc. - Set the theme colors under "Theme" using properties like "Colors". Each color is defined by an RGBA value. - Configure rarity colors under "Rarity Colors". - To modify the window title or description (above the rewards), go through the lang files (Oxide/Lang/<lang>/CustomRewards_<type>). Example Lang file : { "Messages": { "Title": "Rewards", "Description": "Every time you earn points, you can claim your rewards here." } } Step 4: Reward Configuration Under "Rewards Settings": - "Rewards List": Here, you'll define each individual reward for this type. - "Rarity (Common - Rare - Epic - Legendary)": Set the reward's rarity. - "Quantity": If the reward is an item, set the quantity here. - "Item Shortname (optional)": If the reward is an item, set its short name here. - "Custom image URL (optional)": For a custom image for the reward. - "Server command (optional)": Commands to execute when this reward is claimed. - "Grant Permissions ": Permissions to grant when this reward is claimed. - "Grant Groups": Groups to grant when this reward is claimed. - "Nedded Permissions": Permissions needed to claim this reward. - "Nedded Group ": Groups needed to claim this reward. Step 5: Plugin Extensions Under PluginExtensions, you can configure integration with other plugins: - For PlaytimeTracker, use properties under "PlayTimeTracker" like "Count Afk Time?", "Added points", and "Add point every (in seconds)". Step 6: Save and Reload After completing your configuration, save the .json file and reload the plugin on your server. Here's a sample configuration file to help you get started:

Features Be a template for your own plugin Store the last connection time of a player Store the number of death of a player Permissions myplugin.admin - Allows player to use the /myplugin command Commands myplugin help - Displays some help Configuration Default configuration: { "Default Chat Avatar (steamId)": 0 } Localization Default English localization: { "PluginMissing": "The plugin \"SomePlugin\" was not found. Check on UMod: https://umod.org/plugins/someplugin", "NoPermission": "You are not allowed to run this command!", "HelpMessage": "Some useful help!", "UnknownCommand": "Unknown command!" } Hooks DateTime? GetLastConnectionTime(ulong userId) // Return the last connection time (DateTime?) of a player or null if the player is not found int? GetNumberOfDeath(ulong userId) // Return the number (int?) of death of a player or null if the player is not found Credits YourName - Author

Purpose Create some custom plugins for the Rust game using Carbon Oxide Test the plugins with a local server Update the dependencies with a simple script Getting started Download this repository somewhere on your computer (windows only) Run the Workplace_Installer.bat script Open the Plugins.sln solution with Visual Studio or Rider You're done! Update the Frameworks & Server To update the Workplace run Workplace_Updater.bat script This script will call all the update scripts under Scripts\ This action is only requiered on force wipe. However you can run the script by hand if you want to update a specific part of the workplace. It might be usefull when a new version of Carbon or Oxide is released. Please note that the Rust Server will update itself automatically when you start it with the rustserver\Server_Launcher script. Manager the Server To start the server run rustserver\Server_Launcher.bat script Feel free to edit the script to change the server settings. To install Carbon/Oxide on the server run rustserver\Framework_Installer.bat script You will be asked to choose the framework you want to install. To copy all the plugins to the server run rustserver\Plugin_Loader.bat script You will be asked to choose on witch framework you want to load the plugins. Note that Oxide plugins will be loaded enven if you choose Carbon* Extensions There are currently 3 Oxide extensions automatically downloaded: Chaos Discord RustEdit You can simply add more by adding them to the modding\ folder or by editing the Scripts\Extensions.txt file. Carbon extensions are also supported. Documentations I recommend you to read the documentations of the frameworks or browse some existing plugins to understand how they work: Carbon Oxide Rust Server Tools & Versions - .NET Framework 4.8.1 - (C#10) Credits - Author: HandyS11

Rust Snippets Rust Snippets are designed to enhance the coding experience for Rust plugin developers. It streamlines the programming workflow, eliminating the need to repeatedly visit forums or perform repetitive tasks. Rust Snippets integrates all Rust plugin hooks directly into Visual Studio, allowing developers to code on the fly with embedded comments for each hook. Expect regular updates. Shortcuts Setup: Initializes a default Oxide plugin setup. Harmony: Sets up a default Harmony Oxide plugin. Config: Sets up a basic config file. Language: Sets up a basic language file. ChatCommand: Creates a basic ChatCommand. ConsoleCommand: Creates a basic ConsoleCommand. Permissions: Configures basic permissions. Hook Snippets The remaining shortcuts are related to various Rust plugin hooks. Typing "On" or "Can" triggers a dropdown with all available hooks. These hooks currently include all hooks from https://umod.org/documentation/games/rust Tutorial Included in the download is a comprehensive readme that guides users through the setup process. The instructions are easy to follow, ensuring a smooth onboarding experience. Feel free to reach out with any questions. Credits Special thanks to @Billy Joe for the initial idea. Although he didn't continue his work, his contributions inspired me to carry on. Be sure to check out his previous work, he produced some excellent content. I hope I could make your life easier with these snippets

What is Vote System ? Vote System is a sophisticated plugin designed to track player votes in real-time on various ranking sites. It offers two main functionalities: Integration with other plugins: Vote System can be paired with other plugins to enhance its features. See the list of compatible plugins. API for Developers: With a robust API, developers can create plugins that directly interact with the voting system, allowing for advanced customization. Supported Plugins Vote System is compatible with the following plugins: CustomReward: Allows players to receive rewards through a user interface after voting. Economics: Converts votes into virtual currency for players. Documentation : More informations on documentation Supported Ranking Sites Vote System currently supports the following ranking sites: rust-servers.net top-games.net top-serveurs.net

This plugin is only intended for developers to make the development of plugins easier! This plugin lets you specify a directory and will automatically copy all .cs files to your plugin folder when they are changed.

Ruster.NET Addons is a service that allows plugin developers to create and server owners to upgrade and change Ruster.NET in almost any way possible. This plugin provides API and hook support that gives you access to interactions users make in Ruster.NET, from creating your own DM bots with custom commands, to use all the modular panels Ruster.NET provides for your own purposes. Read documentation here or get Addons on this tag. Features API Access Open / close users' browser Open modals with custom (required) fields Open color picker Get users or a specific user Check if users are admins, moderators, verified, developer or a bot Create your own users with custom profile pictures and user configurations (for bots) Get friends of users Get friend requests Get posts for a specific feed or user Get marketplace or advert posts Get blocked users Send or handle friend requests for an user Pin/unpin posts Like/dislike posts Get feed information, such as feed title, type, owner Create posts and publish them on feeds or users' profiles Get or create conversations between users Send messages to players Mark message status (read/unread), and much more. Hook Access On coupons added or removed On language change On custom nickname update On wallet withdraw On restock On hashtag filter On post created/removed On post viewed/closed On post with audio played/stopped On DM sent, and much more. Type Examples Feed Post Marketplace Listing Story Coupon Transaction User Gif Flipbook Modal Field Licensed Item Gift Card User Configuration User Notification Conversation Direct Message Emoji Friend Request Hashtag Business Card Bot Bot Command Check the documentation for more in-depth examples and what you can do so far in Ruster.NET and Ruster.NET Addons.