Keen:Planet Modding/Area Permissions: Difference between revisions

From Medieval Engineers Wiki
Jump to navigation Jump to search
m (Protected "Official Content/Areas Permissions" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
mNo edit summary
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Permissions modding - what is/isn’t allowed to do in claimed areas==
<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}}
[[Category:Keen_Modding_Guides]]</noinclude>
==[[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:
<pre>
<syntaxhighlight lang="xml" line>
<Permission Name="Build">
<Permission Name="Build">
       <Usergroup Groupname="Owner" Allowed="true"/>
       <Usergroup Groupname="Owner" Allowed="true"/>
Line 11: Line 18:
       <Usergroup Groupname="Enemies" Allowed="false"/>
       <Usergroup Groupname="Enemies" Allowed="false"/>
  </Permission>
  </Permission>
</pre>
</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”.


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


===Description of available actions to set permissions for:===
===Description of available actions to set permissions for:===
#Name=”Build” -> block placement permissions
These are for the Permission container and go into Name="". These are also defined in Permissions.sbc
#Name=”Repair” -> Repairing/building already placed blocks
;Build
#Name=”Deconstruct” -> Deconstructing
: block placement permissions
#Name=”QuickDeconstruct” -> Faster deconstruction
;Repair
#Name=”VoxelEdit” -> Mining or shoveling
: Repairing/building already placed blocks
#Name=”Destroy” -> Damage with hand weapons
;Deconstruct
#Name=”Interaction” -> Chest opening, door opening
: Deconstructing
#Name=”ClaimBlockInteraction” -> ClaimblockGui
;QuickDeconstruct
: Faster deconstruction
;VoxelEdit
: Mining or shoveling
;Destroy
: Damage with hand weapons
;Interaction
: Chest opening, door opening
;ClaimBlockInteraction
: ClaimblockGui


===List of available Groupnames:===
===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


#Groupname: “Owner” -> Player who owns area
#roupname: “Allies” -> Mostly faction members of owner of the area
#Groupname: “Neutral” -> Random players, who are not in an enemy faction (mostly everyone without faction allegiance)
#Groupname: “Enemies” -> Players in factions that are hostile to your faction


[[Category:Keen_Modding_Guides]]
<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