Skip to content

vicbarbosa/rust-imperium

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Important: If you have an error spam on your first server start up, just do oxide.reload Imperium and it will be fixed. This bug will be fixed in the next patch soon.

Imperium creates a unique new way to play Rust, first used on servers such as Rust Factions and The Lost Isles. Claim land, fight wars, and battle for supremacy!

At its heart, Imperium adds the idea of "territory" to Rust. The game is divided into a grid of tiles matching those displayed on the in-game map. Players can create factions, and these factions can claim these tiles of land and levy taxes on resources harvested therein. Factions can declare war on one another and battle for control of the territory.

To allow you to restrict PVP only to certain areas, Imperium can also add zones around monuments and events like airdrops and heli crashes. These appear in-game as domes over the areas, and you can choose to block PVP damage outside of these domes.

Imperium is extremely configurable, leading to a wide range of game modes. Here are some ideas!

  • Create a RP/PVE server where players can claim land to avoid being raided, and PVP is restricted to monuments and events.
  • Create a server similar to PVE-Conflict in Conan Exiles, where player structures can't be raided but PVP is allowed everywhere.
  • Create a more traditional PVP server, but factions can claim land and have to declare war on one another in order to raid.

Permissions

  • imperium.factions.admin
  • imperium.claims.admin
  • imperium.badlands.admin
  • imperium.pins.admin
  • imperium.factions

Chat Commands

Commons

  • /i Opens the Imperium UI with all the actions needed by players
  • /help Show Imperium plugin help
  • /map Show Imperium map (The territories info also shows on the in-game map so this is not needed)
  • /pvp Toggle pvp on and off (Can hurt only other players with pvp mode on)

Creating and managing factions

  • /faction create FACTION_NAME Create faction with name
  • /faction invite PLAYER Invite a player to your faction
  • /faction join NAME Join a faction if has been invited
  • /faction show Show information about your faction
  • /faction leave Leave current faction
  • /faction promote PLAYER Promote a faction member to manager role
  • /faction demote PLAYER Demote a faction manager to member role
  • /faction kick PLAYER Remove a member from your faction
  • /faction disband forever Permanently disband your faction
  • /faction help Show help about the faction command

Claiming and managing land

For server admins

  • /claim assign FACTION_NAME Start interaction to assign claim to specified faction (Admin only!)
  • /claim delete XY Delete any claim on the specified land (Admin only!)

For players

  • /claim or /claim add Start interaction to claim the land you are on
  • /claim remove Start interaction to remove claim on the land you are on
  • /claim hq Start interaction to set land as headquarters
  • /claim cost XY Show cost to claim the specified land
  • /claim give FACTION_NAME Give land to another faction
  • /claim list Show a list of claimed land
  • /claim rename XY Rename the specified land
  • /claim upkeep Show the land scrap upkeep (if claim upkeep is enabled in the configs)
  • /claim help Show help about the claim command

Managing taxes

  • /tax chest Start interaction to set faction's tax chest
  • /tax rate XX Set faction tax rate percentage
  • /tax help Show help about the tax command

Declaring war against other factions

  • /war declare FACTION_NAME Declare war against the specified faction
  • /war end FACTION_NAME Ask (or accept) to end the war with the specified faction
  • /war help Show help about the war command

Configuration

  • The Plugin uses icons from /data/ImperiumImages folder. Download this image pack and put ImperiumImages folder inside your server's data folder and everything should work.

TODO: Complete configuration documentation and demonstrative video.

What's new in 2.2.x?

New features

  • Fully functional UI so your players don't have to endlesly type commands anymore! Just type /i in chat. Admin commands are also available in the UI for server admins. (If the buttons don't show for your server admin/mods, let me know in the support forum)
  • Option to allow only the owner and managers to deal damage to structures in their own land (while not at war) to prevent members griefing buildings. (Members can still damage any entities they placed themselves)
  • Option to allow Imperium to manage in-game team system. It will automatically update players teams to match the faction's member list. This also increases the max in-game team size to 128 so you can have huge factions.
  • In-game map overlay improved. Now shows a marker for each faction's headquarters tool cupboard.
  • Added sound effects when important actions happen (Create faction, declare war and so on)
  • Better Chat support (Now shows faction tag in chat)
  • Clans support (Imperium factions will mirror all existing Clans. Note: this disables some Imperium commands since Clans takes control of faction management. Always run your server with both Clans and Imperium loaded to avoid faction desync bugs)
  • Fixed some NullReferenceException bugs from 2.1.x
  • Localization support for almost all chat messages (Still working on UI text localization)

Please report any bugs in the support section.

WORK IN PROGRESS

Some config options already exists but they don't do anything for now because I'm still working on it so ignore the following in your config file:

*war priorAggressionRequired *war spamPreventionSeconds *upgrade maxProduceBonus *upgrade maxRecruitBotBuffs *recruiting enabled

Features planned for the future Allied bot recruiting, player roles, monument conquest, wipe day world war, faction and player reputation system, integration with Clans Reborn, Friends, Server Rewards, Economics, BotRespawn, Raidable Bases and much more!

KNOWN ISSUES

  • Configs from previous versions are not compatible
  • Data files from previous versions are not compatible

Credits

  • chucklenugget, the original author of this plugin

  • evict, the current maintainer

  • Huge thanks to the authors of Zone Manager, Lusty Map and Dynamic PVP, which inspired and guided my work on Imperium. Also a huge thanks to Disconnect and Gamegeared, the admins of The Lost Isles and Rust Factions, who contributed countless ideas to Imperium and were patient as I shook out the bugs.

  • Thanks to CupsOhJoe, the admin of Rusted Cantina for reporting bugs and actively contributing to the development.

  • Special thanks to 2.x.x testers Danilão, AguaRaiss and xlegionario

About

Team up, claim land, and battle for supremacy

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •