summaryrefslogtreecommitdiff
path: root/doc/script_commands.txt
diff options
context:
space:
mode:
authorai4rei <ai4rei@54d463be-8e91-2dee-dedb-b68131a5f0ec>2010-12-12 13:10:08 +0000
committerai4rei <ai4rei@54d463be-8e91-2dee-dedb-b68131a5f0ec>2010-12-12 13:10:08 +0000
commit64324150783c2b822e5263e0e0a9ae0cc23d7ff1 (patch)
treeb8458adc43fbbe83862fc3d14fd1b5c1d5904388 /doc/script_commands.txt
parent664d34d836c774fde315d28b2b96db816573b357 (diff)
downloadhercules-64324150783c2b822e5263e0e0a9ae0cc23d7ff1.tar.gz
hercules-64324150783c2b822e5263e0e0a9ae0cc23d7ff1.tar.bz2
hercules-64324150783c2b822e5263e0e0a9ae0cc23d7ff1.tar.xz
hercules-64324150783c2b822e5263e0e0a9ae0cc23d7ff1.zip
* Updates to the playBGM functionality (since r14335).
- Removed impossible condition in playBGM script command (from soundeffect). - Removed unused code (retrieving of a bl) in playBGMall (from soundeffectall). - Made playBGMall default to 'entire server' when both map name and coordinates are omitted instead of printing an error. - Updated documentation for playBGM and playBGMall to match actual behavior. - Removed unused parameter 'bl' in clif_playBGM. git-svn-id: https://rathena.svn.sourceforge.net/svnroot/rathena/trunk@14582 54d463be-8e91-2dee-dedb-b68131a5f0ec
Diffstat (limited to 'doc/script_commands.txt')
-rw-r--r--doc/script_commands.txt20
1 files changed, 10 insertions, 10 deletions
diff --git a/doc/script_commands.txt b/doc/script_commands.txt
index b3a4ff35d..bc3da5e10 100644
--- a/doc/script_commands.txt
+++ b/doc/script_commands.txt
@@ -4,7 +4,7 @@
//= A reference manual for the eAthena scripting language.
//= Commands are sorted depending on their functionality.
//===== Version ===========================================
-//= 3.32.20101208
+//= 3.33.20101212
//=========================================================
//= 1.0 - First release, filled will as much info as I could
//= remember or figure out, most likely there are errors,
@@ -138,8 +138,8 @@
//= 3.29.20101123
//= Added 'pushpc' command. [Ai4rei]
//= 3.30.20101126
-//= Added 'setfont', 'mercenary_create', 'mercenary_heal', 'mercenary_sc_start',
-//= 'mercenary_create', 'mercenary_get_calls', 'mercenary_set_calls',
+//= Added 'setfont', 'mercenary_create', 'mercenary_heal',
+//= 'mercenary_sc_start', 'mercenary_get_calls', 'mercenary_set_calls',
//= 'mercenary_get_faith' and 'mercenary_set_faith' commands. [Ai4rei]
//= 3.31.20101130
//= Added 'progressbar' command. [Ai4rei]
@@ -148,6 +148,9 @@
//= 'detachrid', 'itemskill', 'openstorage', 'skilleffect', 'donpcevent',
//= 'day', 'night', 'atoi', 'axtoi', 'jump_zero', 'getelementofarray',
//= 'changebase', 'kickwaitingroomall', 'cutin' and 'charcommand'. [Ai4rei]
+//= 3.33.20101212
+//= Updated description of 'playBGM' and 'playBGMall' to reflect the actual
+//= behavior. [Ai4rei]
//=========================================================
This document is a reference manual for all the scripting commands and functions
@@ -6170,19 +6173,16 @@ You can add your own effects this way, naturally.
---------------------------------------
*playBGM "<BGM filename>"
-*playBGMall "<BGM filename>",{,"<map name>"}{,<x0>,<y0>,<x1>,<y1>}
+*playBGMall "<BGM filename>"{,"<map name>"{,<x0>,<y0>,<x1>,<y1>}}
These two commands will play a Background Music to either the invoking character
-only ('playBGM') or multiple characters ('playBGMall'). If the running
-code does not have an object ID (a 'floating' npc) or is not running from an NPC
-object at all (an item script) the sound will be centered on the character who's
-RID got attached to the script, if any. If it does, it will be centered on that
-object. (an NPC sprite)
+only ('playBGM') or multiple characters ('playBGMall').
BGM filename is the filename in /BGM/ folder. It has to be in .mp3 extension.
It's not required to specify the extension inside the script.
-If coordinates are omitted, BGM will be broadcasted on the entire map.
+If coordinates are omitted, BGM will be broadcasted on the entire map. If the map name
+is omitted as well the BGM will be played for the entire server.
You can add your own BGMs this way, naturally.