Customizing Your Server

From DSP Wiki
Revision as of 04:48, 26 August 2012 by PrBlahBlahtson (Talk | contribs) (Added a basic primer on building an NPC to hand out bonuses)

Jump to: navigation, search

Once you know how to build and configure your server correctly, the next thing you may want to know is how to tweak it to your liking

What can I change?

Since the project is open-source, the answer to that is: Absolutely anything, as long as you do not violate the terms of the GPLv2 or newer.

Where do I change things?

Common Options

A lot of the options can be found in scripts/globals/settings.lua including Initial level cap, maximum level allowed on the server, starting gil, starting inventory, unlocking subjobs by default, unlocking advanced jobs by default, and a plethora of other settings to tweak your server. See the file itself for details.

Adjusting Experience

Experience rate can be found in conf/map_darkstar.conf. Change exp_rate: to whatever multiplier you want. If you set it to 2.0 it will give you double experience for all monsters as per the experience tables.

If you prefer to modify the experience granted directly, you can find those values in the exp_table mysql table. To change the amount of experience required to progress to the next level, modify the exp_base mysql table.

Default Character Speed

To adjust the default character run speed, edit src/map/baseentity.cpp and look for a line that says

speed    = 40;

and modify it accordingly. Maximum effective value is 255, and the official test server uses 60.

Starting Jobs and Levels

If you want to change the default starting level for any/all jobs, in the char_jobs table, you need to set the default value for each 3-letter job code to what you want to be the starting level for that job.

You can also change the jobs you have unlocked by default here, but it is easier to use settings.lua if you want to unlock all jobs at the start. Nevertheless, if you wish to tweak exactly what jobs are unlocked, you can adjust the 'unlocked' field by adding together the values of all the jobs you desire below.

Job Name Value
Subjob 1
Warrior 2
Monk 4
White Mage 8
Black Mage 16
Red Mage 32
Thief 64
Paladin 128
Dark Night 256
Beastmaster 512
Bard 1024
Ranger 2048
Samurai 4096
Ninja 8192
Dragoon 16384
Summoner 32768
Blue Mage 65536
Corsair 131072
Puppetmaster 262144
Dancer 524288
Scholar 1048576

Adjust Healing while Resting

In scripts/globals/effects/healing.lua find the lines:




and adjust the 10, 10, and 12 appropriately to change the base healing amounts.

Miscellaneous Changes

To change the name your server provides when people log in, replace all instances (currently 2) of DarkStar in src/login/lobby.cpp with whatever you want.

Player Bonuses NPC

To make an NPC that adds things like maps, jobs, and spells will require a basic understanding of LUA scripting and logic. Refer to How to Make a Quest for a good primer. If all else fails, find an NPC that does what you want and read their code.

First, select the NPC you'd like to modify. The method used on Whasf's server is the "Adventurer's Coupon" turn in, but it's really up to you. Their logic be located in dsp/scripts/zones/zone_name/npcs/npc_name.lua. If the file doesn't exist, you can create it from a text document; just make sure it follows the npc_name.lua convention, and not .txt.

Second, decide what has to be done to trigger the bonuses. Just talk to the NPC? Trade an item? Meet specific conditions, such as being Rank 2, or under level 20? Code your conditions accordingly.

Third, program your unlocks. Refer to ID References for full details on key items, maps, spells, and items. The following code samples cover a few basic rewards:

	-- Adds all maps
		-- ITEMS 389 to 447
		z = 389;
		while z <= 447 do
			z = z + 1;
		-- KEY ITEMS 1856 to 1893
		z = 1856;
			while z <= 1893 do
			z = z + 1;
	-- Adds all 3 starting nation rings
	-- Unlocks subjob
	-- Grants gil and gives the appropriate message
	-- Grants a small amount of fame
		player:addFame(BASTOK,  BAS_FAME*10);
		player:addFame(NORG,    NORG_FAME*10);
	-- Unlocks Dark Knight

Finally, test your NPC for bugs. If anything is wrong, you'll see error messages in the DSGame-server window of your server. Make sure you haven't missed a semi-colon, left a parenthesis open, or missed an "end" after an "if."