Keen:Planet Modding/Area Permissions

OFFICIAL CONTENT NOTICE 

OFFICIAL CONTENT

This article contains official content from or verified by the developers at Keen Software House. This information is intended to be accurate at the time it is posted, but may become obsolete over time. If you find errors in this article please describe the errors in the Discussion Page.

Version:

0.4

Permissions modding - what is/isn’t allowed to do in claimed areas

Have you noticed you cannot mine voxels in claimed areas of your enemies? That is because of how we chose to define permission settings for safe area. And yes, this and much more is also moddable :). This time there is no need create any textures, we will only need to edit one text file and add it to your mod. You will find the file with permissions definitions in Data\Permissions.sbc Descriptions of permission nodes:

<Permission Name="Build">
      <Usergroup Groupname="Owner" Allowed="true"/>
      <Usergroup Groupname="Allies" Allowed="true"/>
      <Usergroup Groupname="Neutral" Allowed="false"/>
      <Usergroup Groupname="Enemies" Allowed="false"/>
 </Permission>

Permission definition sets which groups of players are allowed to perform an action. In this example, it is “Build” action.

<Usergroup Groupname=”Owner” Allowed=”true”>

Groupname refers to group of players, for which we are setting the permission(in this example it is player who owns the area). Allowed parameter allows/disallows the action depending on if it is set to “true” or “false”.

<IsDefault>true</IsDefault> Parameter sets which area permission set is used for player owned territories.

Description of available actions to set permissions for:

These are for the Permission container and go into Name="". These are also defined in Permissions.sbc

Build

block placement permissions

Repair

Repairing/building already placed blocks

Deconstruct

Deconstructing

QuickDeconstruct

Faster deconstruction

VoxelEdit

Mining or shoveling

Destroy

Damage with hand weapons

Interaction

Chest opening, door opening

ClaimBlockInteraction

ClaimblockGui

List of available Groupnames:

These are for the Usergroups and go into Groupname=""

Owner

Player who owns area

Groupname Allies

Mostly faction members of owner of the area

Neutral

Random players, who are not in an enemy faction (mostly everyone without faction allegiance)

Enemies

Players in factions that are hostile to your faction

View the full Planet Modding Guide