Keen:Planet Modding/Area Permissions: Difference between revisions

From Medieval Engineers Wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
<noinclude>{{Version <!-- Do not change the version until the entire page is up-to-date -->
<noinclude>{{SEO|image_url=http://www.medievalengineerswiki.com/images/b/b7/KeenLogoBig.png|description=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.}}
{{Keen:OCH}}
 
 
{{Version <!-- Do not change the version until the entire page is up-to-date -->
|release=0|major=4|minor=X|suppress=true}}
|release=0|major=4|minor=X|suppress=true}}
[[Category:Keen_Modding_Guides]]</noinclude>
[[Category:Keen_Modding_Guides]]</noinclude>
==[[Official Content/Planet Modding/Area Permissions|Permissions modding - what is/isn’t allowed to do in claimed areas]]==
==[[Keen:Planet Modding/Area Permissions|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 :).
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.
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
You will find the file with permissions definitions in Data\Permissions.sbc
Descriptions of permission nodes:
Descriptions of permission nodes:
<source lang="xml">
<syntaxhighlight lang="xml" line>
<Permission Name="Build">
<Permission Name="Build">
       <Usergroup Groupname="Owner" Allowed="true"/>
       <Usergroup Groupname="Owner" Allowed="true"/>
Line 14: Line 18:
       <Usergroup Groupname="Enemies" Allowed="false"/>
       <Usergroup Groupname="Enemies" Allowed="false"/>
  </Permission>
  </Permission>
</source>
</syntaxhighlight>
Permission definition sets which groups of players are allowed to perform an action. In this example, it is “Build” action.
Permission definition sets which groups of players are allowed to perform an action. In this example, it is “Build” action.


<pre><Usergroup Groupname=”Owner” Allowed=”true”></pre>
<syntaxhighlight lang="xml"><Usergroup Groupname=”Owner” Allowed=”true”></syntaxhighlight>
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”.
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”.


Line 25: Line 29:


===Description of available actions to set permissions for:===
===Description of available actions to set permissions for:===
These are for the Permission container and go into Name=""
These are for the Permission container and go into Name="". These are also defined in Permissions.sbc
;Build
;Build
: block placement permissions
: block placement permissions
Line 42: Line 46:
;ClaimBlockInteraction
;ClaimBlockInteraction
: ClaimblockGui
: ClaimblockGui


===List of available Groupnames:===
===List of available Groupnames:===
Line 56: Line 59:




<noinclude>View the full [[Official Content/Planet Modding - Full Guide|Planet Modding Guide]]</noinclude>
<noinclude>View the full [[Keen:Planet Modding - Full Guide|Planet Modding Guide]]</noinclude>

Latest revision as of 20:23, 18 July 2022



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