Server `config.json`

NameTypeExampleDescription
GameNamestringIntersectConfigures the name of the game this server hosts.
ServerPortnumber5400Configures the port this server will listen on.
AdminOnlybooleanfalseConfigures whether this server will only allow staff members (Access 1 or above) to log in.
BlockClientRegistrationsbooleanfalseConfigures whether this server will block new user registrations or not.
UPnPbooleantrueConfigures whether this server will use the UPnP protocol or not.
OpenPortCheckerbooleantrueConfigures whether the server will check if it can be reached from the internet each time it starts.
AnimatedSpritesarray[“bat.png”, “beholder.png”]Configures which sprites should always be animating, even when standing still.
ChatSee Chat
CombatSee Combat
EquipmentSee Equipment
EventWatchdogKillThresholdnumber5000Configures the amount of commands an event may execute within a single server tick before the server considers it to be looping infinitely and kills it off.
GameDatabaseSee Server Database
Lootsee Loot
MapSee Map
MaxClientConnectionsnumber100Configures the amount of clients, logged in or not, which can establish connection to the server at the same time.
MaximumLoggedinUsersnumber50Configures the amount of clients which can be logged in at the same time.
NPCSee NPC
PassabilitySee Passability
PlayerDatabaseSee Server Database
PlayerSee Player
PartySee Party
SecuritySee Server Security
SmtpSettingsSee SMTP
SpritesSee Sprites
ValidPasswordResetTimeMinutesnumber30Configures the time (in minutes) a password reset link is valid for.

Chat

NameTypeExampleDescription
MaxChatLengthnumber120Configures the maximum allowed length of each chat message.
MinIntervalBetweenChatsnumber400Configures the minimum interval (in milliseconds) required between each chat message.
ShowAnnouncementBannersbooleantrueConfigures whether to display announcement banners in the game screen or not.
AnnouncementDisplayDurationnumber15000Configures the time (in milliseconds) to show the announcement banners in the game screen if enabled.

Combat

NameTypeExampleDescription
BlockingSlownumber30Configures the percentage by which to slow a player down while they are blocking.
CombatTimenumber10000Configures the amount of time it takes for a player to no longer be considered in combat after their last attack or the last time they took damage.
MaxAttackRatenumber200Configures the maximum rate at which an entity could potentially attack.
MaxDashSpeednumber200Configures the maximum speed at which a player can dash.
MinAttackRatenumber500Configures the minimum rate at which an entity could potentially attack.
RegenTimenumber3000Configures the time (in milliseconds) between each Vital regeneration tick.
EnableCombatChatMessagesbooleanfalseConfigures whether combat chat messages are enabled or not.
MovementCancelsCastbooleanfalseConfigures whether the player can move around to cancel spell’s casting or not.
MatchGroupCooldownsbooleantrueConfigures whether cooldowns within cooldown groups should match or not.
MatchGroupCooldownHighestbooleantrueConfigures whether cooldowns are being matched to the highest cooldown within a cooldown group when true, or are matched to the current item or spell being used when false. Only used if MatchGroupCooldowns is enabled.
LinkSpellAndItemCooldownsbooleantrueConfigures whether cooldown groups between items and spells are shared. Only used if MatchGroupCooldowns is enabled.
EnableGlobalCooldownsbooleanfalseConfigures whether or not using a spell or item should trigger a global cooldown.
GlobalCooldownDurationnumber1500Configures the duration (in milliseconds) which the global cooldown lasts. Only used if EnableGlobalCooldowns is enabled.
MaxPlayerAutoTargetRadiusnumber15Configures the maximum distance a target is allowed to be from the player when auto targetting.

Loot

NameTypeExampleDescription
ItemDespawnTimenumber15000Configures the time (in milliseconds) which it takes for loot and dropped items to despawn from the map.
ItemOwnershipTimenumber5000Configures the time (in milliseconds) which it takes for a dropped item to no longer be owned by the player that caused it to drop through either killing NPCs and Players or dropping it on the map.
ShowUnownedItemsbooleanfalseConfigures whether everyone on the map can see items that they are not currently the owner of and not eligible to pick up.
ConsolidateMapDropsbooleantrueConfigures whether dropping multiple of an item to the map at once consolidates the drops into a single object on the map if true, or if it drops multiple on the map at once if false.
EnableLootWindowbooleantrueConfigures whether the loot window feature of the client is allowed to be active or not.
MaximumLootWindowItemsnumber10Configures the maximum amount of items to be displayed on the client’s Loot Window. Only used if EnableLootWindow is enabled.
MaximumLootWindowDistancenumber3Configures the maximum amount of tiles around the player to search for loot with the Loot Window. Only used if EnableLootWindow is enabled.

Map

NameTypeExampleDescription
GameBorderStylenumber0Configures the method in which the camera is handled by the engine. 0 will use a seamless world and try to avoid showing areas with no maps in them. 1 will use a seamless world and not constrain the camera to the map view, centering the camera on the player at all times. 2 will not use a seamless world and show each map on its own as you traverse the world.
Heightnumber26Configures the amount of tiles available on the Y (vertical) axis on each map. WARNING: This value can not be changed on the fly and will require you to delete your existing maps when changed!
ItemAttributeRespawnTimenumber15000Configures the amount of time (in milliseconds) it takes for items spawned through the Item Map Attribute to respawn.
TileHeightnumber32Configures the amount of pixels each map tile is on the Y (vertical) axis.
TileWidthnumber32Configures the amount of pixels each map tile is on the X (horizontal) axis.
Widthnumber32Configures the amount of tiles available on the X (horizontal) axis on each map. WARNING: This value can not be changed on the fly and will require you to delete your existing maps when changed!
ZDimensionVisiblebooleanfalseConfigures whether the Z-Dimension is enabled. See Z-Dimensions

NPC

NameTypeExampleDescription
AllowResetRadiusbooleanfalseConfigures whether NPCs will reset after being moved away from the initial point they were first attacked on or started attacking.
ResetRadiusnumber8Configures the range (in tiles) in which an NPC is allowed to move from the initial point they were first attacked on or started attacking before resetting.
AllowNewResetLocationBeforeFinishbooleanfalseConfigures whether NPCs are allowed to obtain a new center point from which they have been pulled before having fully reset to the last.
ResetVitalsAndStatussesbooleanfalseConfigures whether NPCs will fully reset their vitals and statuses when resetting.
ShowLevelByNamebooleanfalseConfigures whether NPCs’ level will be displayed in their overworld name label or not.

Party

NameTypeExampleDescription
MaximumMembersnumber4Configures the maximum amount of party members allowed.
InviteRangenumber40Configures the range (in tiles) in which the player and the player they are attempting to invite to a party must reside within.
SharedXpRangenumber40Configures the range (in tiles) in which party members have to be for them to share experience on kills.
NpcDeathCommonEventStartRangenumber0Configures the range (in tiles) in which party members have to be for them to trigger Common Events from deaths caused by other party members.

Passability

NameTypeExampleDescription
ArenabooleanfalseConfigures whether players can walk through eachother in Arena map types.
NormalbooleanfalseConfigures whether players can walk through eachother in Normal map types.
SafebooleantrueConfigures whether players can walk through eachother in Safe map types.

Player

NameTypeExampleDescription
ItemDropChancenumber0Configures the chance (percentage) of when a player will drop items upon death.
MaxBanknumber100Configures the maximum amount of bank slots each player has.
MaxCharactersnumber1Configures the maximum amount of characters each user account can have.
MaxInventorynumber35Configures the maximum amount of inventory slots each player has.
MaxLevelnumber100Configures the maximum level a player character can reach.
MaxSpellsnumber35Configures the maximum amount of spell slots each player has.
MaxStatnumber255Configures the maximum amount of stat points any given stat can have.
RequestTimeoutnumber300000Configures the maximum amount of time (in milliseconds) a trade request can be left pending before cancelling it automatically.
TradeRangenumber6Configures the range (in tiles) in which the player and the player they are attempting to trade with must reside within.
AllowCombatMovementbooleantrueConfigures whether entities can move or not while their attack timer goes to 0.
ShowLevelByNamebooleanfalseConfigures whether players’ level will be displayed in their overworld name label or not.

SMTP

See Passwords

NameTypeExampleDescription
FromAddressstringnoreply@ascenciongamedev.comConfigures the address from which the server will send e-mails.
FromNamestringAscencion Game DevelopmentConfigures the name the server will use to identify itself as within e-mails.
Hoststringsmtp.myprovider.comConfigures the SMTP server the server will use to send out e-mails.
Portnumber587Configures the port number used to communicate with the SMTP server.
UseSslbooleantrueConfigures whether the SMTP server uses SSL.
Usernamestringmyusername@myprovider.comConfigures the username used to authenticate with the SMTP server.
PasswordstringmypasswordConfigures the password used to authenticate with the SMTP server.

Sprites

NameTypeExampleDescription
IdleFramesnumber4Configures the amount of frames the idle animation sprite contains.
NormalFramesnumber4Configures the amount of frames the normal animation sprite contains.
CastFramesnumber4Configures the amount of frames the cast animation sprite contains.
AttackFramesnumber4Configures the amount of frames the attack animation sprite contains.
ShootFramesnumber4Configures the amount of frames the shoot attack animation sprite contains.
WeaponFramesnumber4Configures the amount of frames the weapon attack animation sprite contains.
NormalSheetAttackFramenumber3Configures the animation from from the normal sheet to use for attacking when no animation sprites are available.
NormalSheetDashFramenumber1Configures the animation from from the normal sheet to use for dashing when no animation sprites are available.
MovingFrameDurationnumber200Configures the time (in milliseconds) each movement frame is displayed before moving on to the next.
IdleFrameDurationnumber200Configures the time (in milliseconds) each idle frame is displayed before moving on to the next.
TimeBeforeIdlenumber4000Configures the time (in milliseconds) it takes after a player’s last action before the idle animation starts playing when available.