Customizing Your Server - Revision history

PrBlahBlahtson at 07:47, 13 June 2013

2013-06-13T07:47:58Z

PrBlahBlahtson at 06:33, 7 June 2013

2013-06-07T06:33:52Z

PrBlahBlahtson at 20:39, 28 May 2013

2013-05-28T20:39:15Z

PrBlahBlahtson at 19:05, 24 May 2013

2013-05-24T19:05:47Z

PrBlah at 21:43, 2 February 2013

2013-02-02T21:43:37Z

Mvd1987: /* Player Bonuses NPC */

2012-10-19T19:17:34Z

‎Player Bonuses NPC

Show changes

Mvd1987: /* Player Bonuses NPC */

2012-10-19T19:15:23Z

‎Player Bonuses NPC

PrBlahBlahtson: Added a basic primer on building an NPC to hand out bonuses

2012-08-26T04:48:38Z

Added a basic primer on building an NPC to hand out bonuses

Bluekirby0 at 00:25, 6 April 2012

2012-04-06T00:25:46Z

Bluekirby0: /* Starting Jobs and Levels */

2012-04-02T11:37:26Z

‎Starting Jobs and Levels

@@ Line 5: / Line 5: @@
 As far as the server goes, since the project is open-source, the answer to that is: Absolutely anything, as long as you do not violate the terms of the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2] or [http://www.gnu.org/licenses/gpl.html newer].
-There are some limitations, though.  In some cases such as spells, the client is programmed to know what is possible.  If, for example, you give a Paladin the spell "Fire," the client knows that this is impossible and will not allow the spell to be cast under any circumstances unless the Paladin would gain it from a correct method, such as having Black Mage as a subjob.
+There are some limitations, though.  In some cases such as spells, the client is programmed to know what is possible.  If, for example, you give a Paladin the spell "Fire," the client knows that this is impossible and will not allow the spell to be cast under any circumstances unless the Paladin would gain it from a correct method, such as having Black Mage as a subjob.  This also applies to level.
 Note that this list may not match what you're used to seeing in retail, which is why Red Mage has spells like Hastega on their spell list if you use @addallspells.  Things like equipment levels and job requirements, as well as Dual wield are enforced in a similar manner.  However, job abilities can be swapped around with relative ease.
 == Where do I change things? ==
@@ Line 141: / Line 143: @@
 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."
-These can also be triggered in /scripts/globals/player.lua inside the CharCreate() function.
+These can also be triggered in /scripts/globals/player.lua inside the CharCreate() function to grant them to new characters as they're created.

@@ Line 3: / Line 3: @@
 == 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 [http://www.gnu.org/licenses/gpl-2.0.html GPLv2] or [http://www.gnu.org/licenses/gpl.html newer].
+As far as the server goes, since the project is open-source, the answer to that is: Absolutely anything, as long as you do not violate the terms of the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2] or [http://www.gnu.org/licenses/gpl.html newer].
 == Where do I change things? ==

@@ Line 8: / Line 8: @@
 === 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.
+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 ===
@@ Line 46: / Line 48: @@
 |Paladin||128
 |-
-|Dark Night||256
+|Dark Knight||256
 |-
 |Beastmaster||512

@@ Line 81: / Line 81: @@
 <code>target:addHP(<span style="color:#ff0000">10</span>+(healtime-2)+(target:getMod(MOD_HPHEAL)));</code>
-<code>target:addMP(<span style="color:#ff0000">12</span>+(healtime-2)+(target:getMod(MOD_MPHEAL))+(target:getMod(MOD_CLEAR_MIND)*(healtime-2)));</code>
+<code>target:addMP(<span style="color:#ff0000">12</span>+((healtime-2) * (1+target:getMod(MOD_CLEAR_MIND)))+(target:getMod(MOD_MPHEAL)));</code>
 and adjust the 10, 10, and 12 appropriately to change the base healing amounts.
@@ Line 88: / Line 88: @@
 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 ===
+=== Perks 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.
+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 can 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.
+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 can be located in /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.
@@ Line 98: / Line 98: @@
 <pre>
-	-- Adds all maps
+	-- Adds all maps (Pre-SoA, no Dynamis)
 		player:addKeyItem(385);
 		player:addKeyItem(386);
@@ Line 134: / Line 134: @@
 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."

@@ Line 91: / Line 91: @@
 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.
+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 can 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.

← Older revision		Revision as of 19:15, 19 October 2012
Line 134:		Line 134:

	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."		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."
		+
		+
		+	i (mvd1987) have made some changes on the script so you also have al jobs unlocked, al teleport crystals,airpas,airpas kazham and choco licence :)
		+	i will edit more when im ready (working on all avatars and more)
		+
		+	this is the edit script now:
		+
		+	-- Adds all maps
		+	player:addKeyItem(385);
		+	player:addKeyItem(386);
		+	player:addKeyItem(387);
		+	player:addKeyItem(388);
		+	player:addKeyItem(138);
		+	player:addKeyItem(352);
		+	player:addKeyItem(353);
		+	player:addKeyItem(354);
		+	player:addKeyItem(355);
		+	player:addKeyItem(356);
		+	player:addKeyItem(357);
		+	player:addKeyItem(9);
		+	player:addKeyItem(8);
		+	player:addKeyItem(WHISPER_OF_FLAMES);
		+	player:addKeyItem(WHISPER_OF_FROST);
		+	player:addKeyItem(WHISPER_OF_GALES);
		+	player:addKeyItem(WHISPER_OF_STORMS);
		+	player:addKeyItem(WHISPER_OF_TIDES);
		+	player:addKeyItem(WHISPER_OF_TREMORS);
		+	player:addKeyItem(WHISPER_OF_THE_MOON);
		+	-- ITEMS 389 to 447
		+	z = 389;
		+	while z <= 447 do
		+	player:addKeyItem(z);
		+	z = z + 1;
		+	end
		+	-- KEY ITEMS 1856 to 1893
		+	z = 1856;
		+	while z <= 1893 do
		+	player:addKeyItem(z);
		+	z = z + 1;
		+	end
		+	-- Adds all 3 starting nation rings
		+	player:addItem(13495);
		+	player:addItem(13496);
		+	player:addItem(13497);
		+	-- Unlocks subjob
		+	player:unlockJob(0);
		+	-- Grants gil and gives the appropriate message
		+	player:addGil(500000);
		+	player:messageSpecial(GIL_OBTAINED,500000);
		+	-- Grants a small amount of fame
		+	player:addFame(BASTOK, BAS_FAME*10);
		+	player:addFame(SANDORIA,SAN_FAME*10);
		+	player:addFame(WINDURST,WIN_FAME*10);
		+	player:addFame(NORG, NORG_FAME*10);
		+	-- Unlocks all jobs
		+	player:unlockJob(8);
		+	player:unlockJob(7);
		+	player:unlockJob(9);
		+	player:unlockJob(10);
		+	player:unlockJob(11);
		+	player:unlockJob(12);
		+	player:unlockJob(13);
		+	player:unlockJob(14);
		+	player:unlockJob(15);
		+	player:unlockJob(16);
		+	player:unlockJob(17);
		+	player:unlockJob(18);
		+	player:unlockJob(19);
		+	player:unlockJob(20);
		+
		+
		+
		+
		+
		+
		+	and here is how i use it in the game:
		+
		+	at C:\dsp\scripts\zones\Bastok_Mines\npcs you search for npcs you want, i choose dry bones.
		+	and edit it like this:
		+
		+	-- Area: Bastok Mines
		+	-- NPC: Dry Bone
		+	-- Standard Info NPC
		+	-----------------------------------
		+
		+
		+	package.loaded["scripts/zones/Bastok_Mines/TextIDs"] = nil;
		+	require("scripts/zones/Bastok_Mines/TextIDs");
		+
		+	-----------------------------------
		+	-- onTrade Action
		+	-----------------------------------
		+
		+	function onTrade(player,npc,trade)
		+	end;
		+
		+	-----------------------------------
		+	-- onTrigger Action
		+	-----------------------------------
		+
		+	function onTrigger(player,npc)
		+	-- Adds all maps
		+	player:addKeyItem(385);
		+	player:addKeyItem(386);
		+	player:addKeyItem(387);
		+	player:addKeyItem(388);
		+	player:addKeyItem(138);
		+	player:addKeyItem(352);
		+	player:addKeyItem(353);
		+	player:addKeyItem(354);
		+	player:addKeyItem(355);
		+	player:addKeyItem(356);
		+	player:addKeyItem(357);
		+	player:addKeyItem(9);
		+	player:addKeyItem(8);
		+	player:addKeyItem(WHISPER_OF_FLAMES);
		+	player:addKeyItem(WHISPER_OF_FROST);
		+	player:addKeyItem(WHISPER_OF_GALES);
		+	player:addKeyItem(WHISPER_OF_STORMS);
		+	player:addKeyItem(WHISPER_OF_TIDES);
		+	player:addKeyItem(WHISPER_OF_TREMORS);
		+	player:addKeyItem(WHISPER_OF_THE_MOON);
		+	-- ITEMS 389 to 447
		+	z = 389;
		+	while z <= 447 do
		+	player:addKeyItem(z);
		+	z = z + 1;
		+	end
		+	-- KEY ITEMS 1856 to 1893
		+	z = 1856;
		+	while z <= 1893 do
		+	player:addKeyItem(z);
		+	z = z + 1;
		+	end
		+	-- Adds all 3 starting nation rings
		+	player:addItem(13495);
		+	player:addItem(13496);
		+	player:addItem(13497);
		+	-- Unlocks subjob
		+	player:unlockJob(0);
		+	-- Grants gil and gives the appropriate message
		+	player:addGil(500000);
		+	player:messageSpecial(GIL_OBTAINED,500000);
		+	-- Grants a small amount of fame
		+	player:addFame(BASTOK, BAS_FAME*10);
		+	player:addFame(SANDORIA,SAN_FAME*10);
		+	player:addFame(WINDURST,WIN_FAME*10);
		+	player:addFame(NORG, NORG_FAME*10);
		+	-- Unlocks all jobs
		+	player:unlockJob(8);
		+	player:unlockJob(7);
		+	player:unlockJob(9);
		+	player:unlockJob(10);
		+	player:unlockJob(11);
		+	player:unlockJob(12);
		+	player:unlockJob(13);
		+	player:unlockJob(14);
		+	player:unlockJob(15);
		+	player:unlockJob(16);
		+	player:unlockJob(17);
		+	player:unlockJob(18);
		+	player:unlockJob(19);
		+	player:unlockJob(20);
		+	player:startEvent(0x1A);
		+	end;
		+
		+	-----------------------------------
		+	-- onEventUpdate
		+	-----------------------------------
		+
		+	function onEventUpdate(player,csid,option)
		+	--printf("CSID: %u",csid);
		+	--printf("RESULT: %u",option);
		+	end;
		+
		+	-----------------------------------
		+	-- onEventFinish
		+	-----------------------------------
		+
		+	function onEventFinish(player,csid,option)
		+	--printf("CSID: %u",csid);
		+	--printf("RESULT: %u",option);
		+	end;
		+
		+
		+
		+
		+	i hope you guys can use this or it makes things easyer for you :)

← Older revision		Revision as of 04:48, 26 August 2012
Line 87:		Line 87:
	=== Miscellaneous Changes ===		=== 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.		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:
		+
		+	<pre>
		+	-- Adds all maps
		+	player:addKeyItem(385);
		+	player:addKeyItem(386);
		+	player:addKeyItem(387);
		+	player:addKeyItem(388);
		+	-- ITEMS 389 to 447
		+	z = 389;
		+	while z <= 447 do
		+	player:addKeyItem(z);
		+	z = z + 1;
		+	end
		+	-- KEY ITEMS 1856 to 1893
		+	z = 1856;
		+	while z <= 1893 do
		+	player:addKeyItem(z);
		+	z = z + 1;
		+	end
		+	-- Adds all 3 starting nation rings
		+	player:addItem(13495);
		+	player:addItem(13496);
		+	player:addItem(13497);
		+	-- Unlocks subjob
		+	player:unlockJob(0);
		+	-- Grants gil and gives the appropriate message
		+	player:addGil(500000);
		+	player:messageSpecial(GIL_OBTAINED,500000);
		+	-- Grants a small amount of fame
		+	player:addFame(BASTOK, BAS_FAME*10);
		+	player:addFame(SANDORIA,SAN_FAME*10);
		+	player:addFame(WINDURST,WIN_FAME*10);
		+	player:addFame(NORG, NORG_FAME*10);
		+	-- Unlocks Dark Knight
		+	player:unlockJob(8);
		+	</pre>
		+
		+	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."

@@ Line 73: / Line 73: @@
 |-
 |}
 === 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.

@@ Line 25: / Line 25: @@
 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 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.
- you can adjust the 'unlocked' field by adding together the values of all the jobs you desire below.
 {|class="wikitable sortable zebra"