wiki:AdvancedSetup
Last modified 7 months ago Last modified on Oct 14, 2011 12:01:03 AM

Advanced gameserver setup

Here you will see all .properties files under your gameserve/config folder with explanations where necessary.

Content:

altsettings.properties
command-privileges.properties
extensions.properties
GMAccess.properties
idfactory.properties
l2jdp-version.properties
l2j-version.properties
olympiad.properties
options.properties
other.properties
pvp.properties
rates.properties
server.properties
sevensigns.properties
siege.properties
telnet.properties

altsettings.properties

Note: Take care not to insert extra spaces at end of line when you edit.
DO NOT COPY AND PASTE SAMPLE FILES, THEY ARE FOR ILLUSTRATIVE PURPOSES ONLY.
Actual content of altsettings.properties file can be find here. (To view or change the content, use your favorite text editor)
#=============================================================
#                WARNING                WARNING
#=============================================================
# Those settings can modify the behaviour of your server.
# Your server will NOT be as retail servers.
# 
# Those settings are usefull if you own some special server
# or really small server.
#=============================================================

#-------------------------------------------------------------
# Server config
#-------------------------------------------------------------
# AutoLoot enable... True to enable, False to disable
AutoLoot = False <<--- TRUE = LOOTED ITEMS WILL COME DIRECTLY IN YOUR INVENTORY, FALSE= YOU HAVE TO PICK THEM FROM GROUND

# AutoLearnSkills... True to enable, False to disable
AutoLearnSkills = False <<---TRUE AS YOUR LEVEL INCREASE SKILLS AVAILABLE WILL BE ADDED TO CHARACTER AUTMOATICALLY, FALSE=YOU MUST VISIT PROPER CLASSMASTER FOR YOR CLASS TO LEARN SKILLS

# If XP loss (and deleveling) is enabled, default is 'true'
Delevel = True <<--- TRUE = ON DIE YOU WILL LOOSE CERTAIN AMOUNT OF XP POINTS

# If disabled, magic dmg has always 100% chance of success, default is 'true'
MagicFailures = False <<--- SELF EXPLANATORY

# Alternative cancel of attack (bow, cast, all)
AltGameCancelByHit = cast <<--- WHAT TYPES OF ATTACK PLAYER CAN CANCEL AFTER ATTACK IS LAUCHED

# Alternative rules for shields - if they block, the damage is powerAtk-shieldDef,
# otherwice it's powerAttak / (shieldDef + powerDef)
AltShieldBlocks = False <<--- SELF EXPLANATORY

# Alternative AltGameMobAttackAI, like C1
AltGameMobAttackAI = False <<--- SELF EXPLANATORY

# Alternative Freight mode. If true, freights can be withdrawed from any place.
# Also, possibility to change Freight price (in adena) for each item slot in freight.
# NOTE: AltGameFreightPrice WILL NOT change the value shown to the player, but the
# player will actually get charged for the value set in here.
AltGameFreights = False
AltGameFreightPrice = 1000 
<<--- SELF EXPLANATORY --->>

# Alternative Xp/Sp rewards, if not 0, then calculated as 2^((mob.level-player.level) / coef),
# A few examples for "AltGameExponentXp = 5." and "AltGameExponentSp = 3."
# diff = 0 (player and mob has the same level), XP bonus rate = 1, SP bonus rate = 1
# diff = 3 (mob is 3 levels above), XP bonus rate = 1.52, SP bonus rate = 2
# diff = 5 (mob is 5 levels above), XP bonus rate = 2, SP bonus rate = 3.17
# diff = -8 (mob is 8 levels below), XP bonus rate = 0.4, SP bonus rate = 0.16
AltGameExponentXp = 0
AltGameExponentSp = 0
<<--- BE CAREFULL USING THIS, EFFECT MAY BE AS INCREASING DEFAULT RATES, SO EVEN YOU SERVER IS x3 
RESULTING VALUES MAY BE SIMMILAR AS x12 RATES!--->>

# Use tiredness (instead of combat points)
AltGameTiredness = False <<--- SELF EXPLANATORY

# EnableMuliplierHp of mobs HP by skills (HIGHLY RECCOMENDED with latest npc.sql)
EnableRateHp = True <<--- TRUE= MOBS WILL HAVE THEIR BASE HP AS YOU CAN SEE IN DATABSE MULTIPLIED WITH STRONG TYPE SKILL VALUE (x2,x3,x4...) SO A MOB WITH 100HP AND STRONG TYPE LVL 2 WILL HAVE 200HP (100x2). FALSE = DEFAULT 
BASE HP IS USED. 

# Alternative settings against player with karma
AltKarmaPlayerCanBeKilledInPeaceZone = False
AltKarmaPlayerCanShop = False
AltKarmaPlayerCanTeleport = False
AltKarmaPlayerCanTrade = False
AltKarmaPlayerCanUseWareHouse = False
<<--- SELF EXPLANATORY --->>

# Allow free teleportation around the world.
AltFreeTeleporting = False <<--- SELF EXPLANATORY

#-------------------------------------------------------------
# Crafting config
#-------------------------------------------------------------
# Crafting enabled/disabled. On by default
CraftingEnabled = True <<--- SELF EXPLANATORY

#Limits for recipes (defal: 50 - for dwarf , 50 - for common)
DwarfRecipeLimit = 50
CommonRecipeLimit = 50
<<--- SELF EXPLANATORY --->>

# Alternative crafting rules:
# - crafting takes time
# - players get EXP/SP for crafting
AltGameCreation = False <<--- TRUE = GETS EXP/SP FOR CRAFTING, FALSE = DON'T GET

# time multiplier - bigger number ===> slower crafting but more XP/SP 
AltGameCreationSpeed = 1 <<--- SELF EXPLANATORY

# Additional XP/SP rate multiplier (for increased XP/SP)  default = 1
AltGameCreationRateXp = 1
AltGameCreationRateSp = 1
<<--- SELF EXPLANATORY --->>
#-------------------------------------------------------------
# Skills config
#-------------------------------------------------------------
# Allow use Event Managers for change occupation
# If you need change occupation only use quest then set this to False
# Default = False
AllowClassMasters = False <<-- TRUE = THAT CAT WILL SPAWN IN CITIES ALLOWING INSTANT CHANGING OCCUPATION, FALSE = PLAYERS HAVE TO MAKE CLASS CHANGE QUESTS TO CHANGE THEIR OCUPATION

# Spell Book needed to learn skills
SpBookNeeded = True <<--- SELF EXPLANATORY

# Alternative skill learn rules:
# - all classes can learn all skills
# - skills of another class costs x2 SP
# - skills of another race costs x2 SP
# - skills of fighters/mages costs x3 SP
AltGameSkillLearn = False
<<--- SELF EXPLANATORY --->>

# Allow player sub-class addition without checking for unique quest items.
AltSubClassWithoutQuests = True <<--- TRUE = INSTANT SUB-CLASS ADDITION BY VISITING CLASS MASTERS, FALSE =
 QUEST ITEM REQUIRED
# Alternative success rate formulas for skills such Sleep/Root/Stun/Dagger ones,
# 'none' or 'false' for standart, 'alt' - for alternative and 
AltGameSkillFormulas = none
<<--- SELF EXPLANATORY --->>

# Skill Hit Time multiplier
AltGameSkillHitRate = 1. <<--- SELF EXPLANATORY
#-------------------------------------------------------------
# Festival config
# // Moved to sevensigns.properties
#-------------------------------------------------------------

#-------------------------------------------------------------
# Clans config
#-------------------------------------------------------------
# Number of days you have to wait before :
#   - joining another clan
DaysBeforeJoinAClan = 5 <<--- IN EFFECT FOR PLAYERS THAT LEAVED A CLAN
#   - creating a new clan <<--- IN EFFECT FOR CLAN LEADERS THAT DISOLVED A CLAN
DaysBeforeCreateAClan = 10

# Number of members needed to request a clan war
AltClanMembersForWar = 15 <<--- SELF EXPLANATORY

# All new characters of the same account are newbies, not only first one
AltNewCharAlwaysIsNewbie = False <<--- TRUE= ALL CHARACTERS BELONG TO SAME ACCOUNT WILL HAVE NEWBIE STATUS,
FALSE = ONLY FIRST CREATED WILL HAVE NEWBIE STATUS

#-------------------------------------------------------------
# Olympiad config <<--- SELF EXPLANATORY
#-------------------------------------------------------------
.........
.........
#-------------------------------------------------------------
# Lottery config <<--- SELF EXPLANATORY
#-------------------------------------------------------------
........
........

command-privileges.properties

Content of file is not listed as all settings are self explanatory.
Actual content of command-privileges.properties file can be find here.
# Alternative Configure GM commands access level
#
# This file only read if "AltPrivilegesAdmin = True"!!! <<--- YOU CAN FIND THIS LINE IN OTHER.PROPERTIES FILE
#
# Information:

# 1) If AltPrivilegesSecureCheck = True <<--- YOU CAN FIND THIS LINE IN OTHER.PROPERTIES FILE

#    Every commands need a entry in this file, else the command cannot be executed.
#    else if a command haven't got a entry in this file the minimun access level is
#    AltPrivilegesDefaultLevel (default = 100)
# 2) Some commands need a correct access level on GM Access table too, like:  
#    the commands contained into AdminEditChar.java,AdminEditNpc.java,AdminSpawn.java files

GMAccess.properties

Content of file is not listed as all settings are self explanatory.
Actual content of GMAccess.properties file can be find here.
#Disable Transaction
# False = Transaction enable for GM
# Max,Min = Transaction disable for this range
GMDisableTransaction = False <<--- FALSE = ANY GM CAN MAKE TRANSACTION, MIN,MAX - SPECIFY MIN AND MAX GM ACCESS LEVELS ALLOWED TO MAKE TRANSACTIONS

idfactory.properties

Actual content of idfactory.properties file can be find here.
# Allows selection of new Classes for storage of World Objects.
# This may help servers with large amounts of players recieving error
# messages related to the L2ObjectHashMap and L2ObejctHashSet classes.
#
# By default it uses the new method, to use the old classes add the
# comment at the front of each line.
L2Map = WorldObjectMap
L2Set = WorldObjectSet
<<--- SELF EXPLANATORY --->>

# Tell server which IDFactory Class to use
# Options are:
# Compaction (Original method),
# BitSet (One non compaction method - default),
# Stack  (Another non compaction method)
IDFactory = BitSet <<--- RECOMMENDED BitSet, Compaction MAY BE OUTDATED

# Check for bad ids in the database on server boot up
# Much faster load time without it, but may cause problems
BadIdChecking = True <<--- RECOMMENDED TRUE, IF FALSE MAY CORRUPT DATA

l2j-version.properties

This file is created when compile server To proper display version you need subversion:

http://www.tigris.org/files/documents/15/24487/svn-1.2.1-setup-2.exe
Subversion is optional.

    	version=110
    	builddate=20061031_2350 
Detailed Info:
    	   committed-rev="110"
name=""
committed-date="2006-11-01T01:34:36.032348Z"
url="file:///var/www/svn/L2J/trunk/L2_GameServer_c5"
Last-author="Luno"

l2jdp-version.properties

Same as l2j-version.properties, show DP version.

options.properties

Actual content of options.properties file can be find here.
# =================================================================
# Test server setting, shoudnt be touched in online game server
# =================================================================

Debug = False
Assert = False
Developer = False
# if true the server will be a test server (listed by clients setted up to list testserver)
TestServer = False
<---- LEAVE THIS AS IS UNLESS YOU KNOW WHAT YOU'RE DOING---->

# =================================================================
# Additional server setting, not required, can be left at defaults
# =================================================================

# If next switch set to true every created character will have access level 200.
EverybodyHasAdminRights = False <<--- BE VERY CAREFUL ENABLING THIS!!! IF TRUE PLAYERS WILL RUIN YOUR SERVER!

# Setting for serverList
# Displays [] in front of server name
ServerListBrackets = False
# Displays a clock next to the server name
ServerListClock = False
# If true, the server will be set as gm only at startup
ServerGMOnly = False <<--- IF TRUE ONLY GM CAN ENTER SERVER

# This is setting of experimental Client <--> Server Player coordinates synchronization,
#   0 - no synchronization at all
#   1 - parcial synchronization Client --> Server only * using this option it is difficult for players to bypass obstacles
#   2 - parcial synchronization Server --> Client only
#   3 - full synchronization Client <--> Server
#  -1 - Old system: will synchronize Z only
CoordSynchronize = -1 <<--- YOU MAY EXPERIENCE THOSE SETTING AND SE WICH ONE IS BEST FOR YOU

# Zone Setting
#   0 = Peace All the Time
#   1 = PVP During Siege
#   2 = PVP All the Time
ZoneTown = 0
<<--- SELF EXPLANATORY --->>

# Chat configuration
# Global Chat - ON (=region), OFF, GM, GLOBAL
GlobalChat = ON
# Trade Chat - ON (=global), OFF, GM, LIMITED (=region)
TradeChat = ON
<<--- GLOBAL = WHOLE SERVER, REGION= ONLY AREA WHERE PLAYER IS --->>

# Player punishment for illegal acions
#   1 - broadcast warning to gms only
#   2 - kick player(default)
#   3 - kick & ban player
#   4 - jail player (define minutes of jail with param: 0 = infinite)
DefaultPunish = 2
DefaultPunishParam = 0 <<--- SET THIS ONLY IF USING DefaultPunish = 4 

# Bypass exploit protection
BypassValidation = False <<--- IF TRUE SERVER WILL NOT USE EXPLOIT PROTECTION

# Enforce gameguard for clients
#   GameGuardEnforce - enforces gameguard query on character login
#   GameGuardProhibitAction - dont allow player to perform trade, talk with npc
#     and move until gameguard reply received
GameGuardEnforce = False
GameGuardProhibitAction = False
<<--- SET TO TRUE IF YOU WANT GAMEGUARD CHECK --->>

# Day/Night Status
# Hours are from 0 - 23
DayStatusSunRiseAt = 6
DayStatusSunSetAt = 18
# Forces the client to change their day and night status
DayStatusForceClientUpdate = True
<<--- SELF EXPLANATORY --->>

# Allow delete chars after nnn days, 0 - feature disabled
DeleteCharAfterDays = 7 <<--- SELF EXPLANATORY


# =================================================================
# Server optimisations
# =================================================================
# delete from world dropped reward items after n seconds. 0 - disabled
AutoDestroyDroppedItemAfter = 0 <<--- WILL DELETE LOOT AFTER SPECIFIED AMOUNT OF TIME
# delete invalid quest from player
AutoDeleteInvalidQuestData = False
# setting false can improve server performance on high rate servers
PreciseDropCalculation = True
# allows creating multiple nonstackable items at one time 
MultipleItemDrop = True

# Forces full item inventory packet to be sent for any item change
# Note: This can increase network traffic 
ForceInventoryUpdate = False <<--- LEAVE IT FALSE UNLESS YOU EXPERIENCING PROBLEMS WITH ITEMS DISAPPEARING FROM PLAYERS

# Set the html cache's lazy loading True or False
# (Load html's into cache only on first time requested)
LazyCache = True <<--- TRUE = WILL LOAD ALL HTML FILES ON STARTUP EVERYTIME

# Maximum range mobs can randomly go from spawn point
MaxDriftRange = 200 <<--- DO NOT USE HIGHER VALUES OR MOBS MAY SPAWN IN THE WALLS

# Minimum and maximum variable in seconds for npc animation delay.
# You must keep MinNPCAnimation <= MaxNPCAnimation.
# "0" is default value.
MinNPCAnimation = 0
MaxNPCAnimation = 0
<<--- BETTER LEAVE THOSE VALUES AT 0 OR NPC WILL LOOK LIKE FOOLS THAT TALK ALONE :) --->>

# Show L2Monster level and aggro 
ShowNpcLevel = False <<--- SELF EXPLANATORY

# Activate the position recorder
# valid 3D points will be recorded and written to data/universe.txt on shutdown
ActivatePositionRecorder = False <<--- DO NOT SET TO TRUE UNLESS YOU WANT TO CREATE A MAP MADE OF THOSE POINTS

# =================================================================
# Additionnal features than can be enabled or disabled
# =================================================================
# If you are experiencing problems with Warehouse or Freight transactions,
# feel free to disable them here. (They are both enabled by default).
AllowWarehouse   = True
AllowFreight     = True
# If True player can try on weapon and armor in shop
# Each Item tried cost WearPrice adena
AllowWear        = True
WearDelay        = 10 <<--- SECONDS
WearPrice        = 10
# =============== Test features ===============
AllowLottery     = False
AllowRace        = False
AllowWater       = False <<--- LEAVE IT FALSE UNTIL GEODATA IS IMPLEMENTED
# Enable pet for rent(wyvern&strider) from pet managers
AllowRentPet     = False
# Allow players to drop items on the ground
AllowDiscardItem = True <<--- IF YOU EXPERINCE PROBLEMS WITH PLAYERS DROPPING STUFF ON GROUND, SET IT TO FALSE :)
# Allow fishing disabled until all code uploaded
AllowFishing     = False <<--- RECOMMNEDED TRUE FOR LOW RATES SERVERS
#Allow boat
AllowBoat        = False <<--- RECOMMNEDED TRUE LOW RATES SERVERS

# Allow L2Walker client (Default False)
# Can be True, False, GM
AllowL2Walker      = False
L2WalkerRevision   = 552
# Ban account if account using l2walker and is not GM, AllowL2Walker = False
AutobanL2WalkerAcc = False
<<--- SELF EXPLANATORY --->>

# =================================================================
# Logging features <<--- SELF EXPLANATORY --->>
# =================================================================
...
...

# =================================================================
# Community board configuration <<--- SELF EXPLANATORY --->>
# =================================================================
...
...

# =================================================================
# Threads configuration - Take care changing this
# =================================================================

ThreadPoolSizeEffects = 10
ThreadPoolSizeGeneral = 13

#Default 2
UrgentPacketThreadCoreSize = 2
#Default 4
GeneralPacketThreadCoreSize = 4
#Default 4
GeneralThreadCoreSize = 4

AiMaxThread = 6


# Thread pools execution priority
# default values are -1,0,1 (low/med/high pools)
ExecutorPriLow = -1
ExecutorPriMed = 0
ExecutorPriHigh = 1

#Packet LifeTime in miliseconds, 0 - disabled feature
PacketLifeTime = 0

<<--- BE VERY CAREFULL EDITING ABOVE VALUES. YOU MAY TRY TO SEE WHAT IS BEST FOR YOUR SERVER AS THOSE VALUES DEPENDS
ON MANY FACTORS AS OS, PC, AMOUNT OF PLAYERS, ETC --->>

#Grid options: Grids can now turn themselves on and off.  This also affects
#the loading and processing of all AI tasks and (in the future) geodata 
#within this grid.
#Turn on for a grid with a person in it is immediate, but it then turns on 
#the 8 neighboring grids based on the specified number of seconds.
#Turn off for self and neighbors occures after the specified number of 
#seconds have passed during which a grid has had no players in or in 
#any of its neighbors.
#The always on option allows to ignore all this and let all grids be active
#at all times
GridsAlwaysOn = False <<-- RECOMMNEDED FALSE
GridNeighborTurnOnTime = 30 <<--- SELF EXPLANATORY
GridNeighborTurnOffTime = 300 <<--- SELF EXPLANATORY

#GeoData options: True to turn on GeoData, or False to turn off (Defaul False)
GeoData = False

pvp.properties

Content of file is not listed as all settings are self explanatory.
Actual content of pvp.properties file can be find here.

server.properties

This file is described in How to set up Loginserver and Gameserver page.

siege.properties

Content of file is not listed as all settings are self explanatory.
Actual content of siege.properties file can be find here.

telnet.properties

Content of file is not listed as all settings are self explanatory.
Actual content of telnet.properties file can be find here.



WikiStart