SphereWiki - User contributions [en]

De:How Combat Works

2010-11-28T12:14:07Z

Taro: Created page with '{{Languages|How_Combat_Works}} Das folgende Diagramm zeigt in welcher reinfolge die Trigger ausgelöst werden. Sehe auf die jeweiligen Trigger-Seiten für weitere einzelne ...'

{{Languages|How_Combat_Works}}

Das folgende Diagramm zeigt in welcher reinfolge die [[Trigger]] ausgelöst werden. Sehe auf die jeweiligen Trigger-Seiten für weitere einzelne Informationen für das Auslösen.

<tt>       @HitTry (Angreifer) 
           /           \ 
@Hit (Angreifer)    @HitMiss (Angreifer) 
       | 
@Damage (Waffe) 
       | 
@GetHit (Opfer) 
       | 
@Damage (Rüstung) </tt>

Dank für dieses Posting Moe.

[[Category:Articles]]

Main Page

2009-08-04T19:49:29Z

Taro: /* External Links */ Bad Link

Welcome to the retake of Taran's famous "[http://www.cs.rit.edu/~djr7581/ Sphere Scripting for Dummies tutorials]" and information. His tutorial was made for Sphere 55i, but now that Sphere 56b is about to be released we have decided to rewrite his tutorials and update the information to reflect the latest changes and additions.

'''Where should I start?'''

If you want to learn to script for Sphere 56b you should start by first reading the [[#Setting Up Sphere|Setting Up Sphere]] section. It will teach you how to set up a basic empty world to start your path. After that you should try reading the [[#Tutorials|Tutorials]], go slow, don't try to go through everything in one day as it takes time to read and fully understand everything.

'''I learned how to script! And now?'''

If you have finished the 10 chapters then we encourage you to read the tutortials and other articles below. They may not be as important as the others but they are still quite useful and contain lots of useful information. Try making your own scripts and share with others at the [http://www.sphereserver.net/index.php SphereServer Forums]. You can also ask for help if you can't resolve something by yourself. Remember to use the [[#Reference Compendium|Reference Compendium]] below as it is really useful.

'''I want to contribute!'''

Maintaining the information on this site involves a huge amount of work and not many of us have the time to do it. If you wish to help out then please feel free to do so! All you need to do to get started is [[Special:UserLogin|create an account]] if you haven't done so already. You can then edit any page by using the "Edit" link in the rop right corner. Before you go do this, you may want to start by reading the [[Contribution Guide]].

'''Special thanks to:'''

[[WhoIsWho|Ben, Cloud_Br, Ellessar, Jdog, Lord Zerofiz, Mordaunt, Nazghul-ll, RanXerox, Rattlehead, Sandman, Sharlenwar, ShiryuX, thelegbra, Maximus and WarAngel]], for helping to add content.

[[WhoIsWho|Daleth]], for writing the Sphere Reference Project, and [[WhoIsWho|Mordaunt]] for converting it to .chm format.

[[WhoIsWho|Tracker]], for writing the Sphere 56 Tracking Changes in Sphereserver.net

[[WhoIsWho|Taran]], for writing the original and now famous Sphere Scripting for Dummies tutorials, and [[WhoIsWho|MrSugarCube]] for bringing it up-to-date directly from source.

[[WhoIsWho|Furio, Radiant, Vjaka, Nazghul-ll, Ellessar, Torfo, Shadow Dragon and MrSugarCube]] for continuing to develop Sphere into a powerful and very customizable Ultima Online emulator.

[[WhoIsWho|Crius]], for providing hosting for the original SphereWiki, and [[WhoIsWho|Torfo]] for providing the current hosting.

----

==Setting up Sphere==

* [[Where to get Sphere]]
* [[Installing Sphere]]
* [[Configuring Sphere.ini]]

==Tutorials==

Here are the chapters of Taran's original compendium, updated for Sphere56b:

* [[Chapter 1]] ''(Numbers, DEFNAME, ITEMDEF, CHARDEF)''
* [[Chapter 2]] ''(Sphere files explained)''
* [[Chapter 3]] ''(Scripting NPC's and items, Cool commands)''
* [[Chapter 4]] ''(Objects, operators, speech)''
* [[Chapter 5]] ''(Tags, Vars, Locals, Functions)''
* [[Chapter 6]] ''(LINKs, TIMERs, TARGETs)''
* [[Chapter 7]] ''(Loops and powerful functions)''
* [[Chapter 8]] ''(SKILLMENUs, MENUs, Gumps)''
* [[Chapter 9]] ''(Events)''
* [[Chapter 10]] ''(String Handling)''

In addition to these there are some more advanced tutorials that have been contributed by other members. Once you have read the above 10 tutorials you may wish to read these to learn more:

* [[Common Mistakes|Common Mistakes Explained]] ''(A revision of Maximus's tutorial on the forums, and continuation of Taran's Misconceptions tutorial)''
* [[Internet and Sphere]] ''(And how to make the right use of them)''
* [[Languages Tutorial]] ''(How to script your own language system)''
* [[Making your own Skills]] ''(How to make and customize your skill)''
* [[Mul Patching Tutorial|Nazghul's Mul Patching Tutorial]] [http://sorea.profitux.cz/patching/ external link] ''(A document about mul patching and customizing your server)''
* [[Overriding Hardcoded Commands]] ''(How to override hardcoded commands and functions)''
* [[Scheduled Reboot]] ''(How to schedule system reboots)''
* [[Using MySQL]] ''(How to use MySQL)''

==Reference Compendium==

* [[:Category:Definitions|Definitions]]
** [[CHARDEF|Characters]]
** [[DIALOG|Dialogs]]
** [[EVENTS|Events]]
** [[ITEMDEF|Items]]
** [[MENU|Menus]]
** [[REGIONRESOURCE|Region Resources]]
** [[REGIONTYPE|Region Types]]
** [[AREADEF|Regions]]
** [[ROOMDEF|Rooms]]
** [[SKILLCLASS|Skill Classes]]
** [[SKILLMENU|Skill Menus]]
** [[SKILL|Skills]]
** [[SPELL|Spells]]
** [[TYPEDEF|Types]]
* [[:Category:Objects|Objects]]
** [[Accounts]]
** [[Characters]]
** [[Database]]
** [[Files]]
** [[GM Pages]]
** [[Items]]
*** [[Special Items]]
** [[Map Points]]
** [[Parties]]
** [[Regions]]
** [[Rooms]]
** [[Sectors]]
** [[Server]]
* [[:Category:Scripts|Scripts]]
** [[:Category:Functions|Functions and Triggers]]
** [[:Category:Variables|General Functions, Properties and References]]
** [[Intrinsic Functions]]
** [[:Category:Statements|Statements]]

==Other Articles==

* [[Armor Calculation]]
* [[Client Changes]]
* [[Common Scripting Misconceptions]]
* [[Custom Object Properties]]
* [[Error Codes]]
* [[Experience System]]
* [[How Combat Works]]
* [[Occam's Razor]]
* [[Optimization|Optimization Theory]]
* [[Override TAGs]]
* [[Revisions Changelog]]
* [[Sendpacket]]
* [[Skill Gain Theory]]
* [[The Process of Scripting]]

==External Links==

* [http://www.sphereserver.net/ Official SphereServer Website]
* [http://prerelease.sphereserver.net/ Official Sphere 56b Downloads]
* [http://scriptsharing.dv-team.de/ ScriptSharing]
* [http://www.cs.rit.edu/~djr7581/ Taran's Scripting for Dummies (Sphere 55i)]
* [http://uo.torfo.org/packetguide/ Jerrith's UO Packet Guide]
* [http://uo.torfo.org/packetguideKR/ Wyatt&Kons's UOKR Packet Guide]

[[Category: Navigation]]

DIALOG

2009-08-04T05:34:59Z

Taro: Edit: dhtmlgump prefixes

__FORCETOC__
Dialogs are a more advanced form of user interface whose layout can be completely customised.

==Syntax==
The definition of a dialog consists of ''three'' different blocks of script; a layout, a list of text strings used in the dialog and a buttons section which handles button responses from the client.

===Layout===
The layout section of the dialog defines how the dialog will look to clients.

<tt>
[DIALOG ''defname''] 
''x, y'' 
''script'' 
</tt>

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Description'''
|-
| ''defname'' || The dialog's defname.
|-
| ''x, y'' || The screen coordinates to display the dialog at.
|-
| ''script'' || The dialog's layout script.
|}

The script text can be a complete script that is executed in the same way as a function or trigger script, and can even contain conditional statements to display different layouts to different clients if desired. The default object is the [[Characters|character]] or [[Items|item]] that the dialog has been called upon, and [[SRC]] is the [[Characters#Clients|client]] who is viewing the dialog. If the dialog ends with a "RETURN 1" then Sphere will cancel displaying the dialog.

In addition to the usual functions, properties and references you would have access to in a normal script, there are also functions that place elements on to the dialog. The following table lists all elements that can be used:

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Description'''
|-
| [[button]] ''x y gump_down gump_up is_pressable page id'' || Places a button on to the page
|-
| [[buttontileart]] ''x y gump_down gump_up is_pressable page id tile_id tile_hue tile_x tile_Y'' || Places a button on to the page, with an item image placed over the top as part of the button.
|-
| [[checkbox]] ''x y gump_check gump_uncheck initial_state id'' || Places a checkbox on to the page.
|-
| [[checkertrans]] ''x y width height'' || Adds a transparent area of the dialog.
|-
| [[croppedtext]] ''x y width height colour text_index'' || Places some text on to the page that wraps to specified boundaries.
|-
| [[dcroppedtext]] ''x y width height colour text || Places some text on to the page that wraps to specified boundaries. Accepts dynamic coordinates relative to [[dorigin]] using '''-''', '''+''', '''*''' prefixes.
|-
| [[dorigin]] ''x y'' || Sets the origin coordinates for dynamically positioned elements.
|-
| [[dhtmlgump]] ''x y width height has_background has_scrollbar text'' || Places some HTML text on to the page. Accepts dynamic coordinates relative to [[dorigin]] using '''-''', '''+''', '''*''' prefixes.
|-
| [[dtext]] ''x y colour text'' || Places some text on to the page. Accepts dynamic coordinates relative to [[dorigin]] using '''-''', '''+''', '''*''' prefixes.
|-
| [[dtextentry]] ''x y width height colour id text'' || Places a text entry field on to the page where the client can enter text. Accepts dynamic coordinates relative to [[dorigin]] using '''-''', '''+''', '''*''' prefixes.
|-
| [[dtextentrylimited]] ''x y width height colour id limit text'' || Places a text entry field on to the page where the client can enter a limited amount of text. Accepts dynamic coordinates relative to [[dorigin]] using '''-''', '''+''', '''*''' prefixes.
|-
| [[group]] ''id'' || Defines a new group ID, for grouping sets of radio buttons.
|-
| [[gumppic]] ''x y gump hue'' || Places a gump on to the page.
|-
| [[gumppictiled]] ''x y width height gump'' || Tiles a gump over an area of the page.
|-
| [[htmlgump]] ''x y width height text_index has_background has_scrollbar'' || Places some HTML text on to the page.
|-
| [[noclose]] || Prevents the dialog from being closed when right-clicked.
|-
| [[nodispose]] || Prevents the dialog from being closed by the "Close Dialogs" macro.
|-
| [[nomove]] || Prevents the dialog from being moved around the screen.
|-
| [[page]] ''num'' || Begins defining page ''num'' of the dialog. (page 0 content is shown on all pages)
|-
| [[radio]] ''x y gump_check gump_uncheck initial_state id'' || Places a radio button on to the page.
|-
| [[resizepic]] ''x y gump width height'' || Places a multi-part ''gump'' on to the page, often used for dialog backgrounds.
|-
| [[text]] ''x y colour text_index'' || Places some text on to the page.
|-
| [[textentry]] ''x y width height colour id text_index'' || Places a text entry field on to the page where the client can enter text.
|-
| [[textentrylimited]] ''x y width height colour id text_index limit'' || Places a text entry field on to the page where the client can enter a limited amount of text.
|-
| [[tilepic]] ''x y item_id'' || Places an item image on to the page.
|-
| [[tilepichue]] ''x y item_id hue'' || Places a coloured item image on to the page.
|-
| [[tooltip]] ''cliloc_id'' || Places a tooltip on to the page.
|-
| [[xmfhtmlgump]] ''x y width height clilod_id has_background has_scrollbar'' || Places some localised HTML text on to the page.
|-
| [[xmfhtmlgumpcolor]] ''x y width height cliloc_id has_background has_scrollbar colour'' || Places some localised HTML text on to the page with the specified colour.
|-
| [[xmfhtmltok]] ''x y width height has_background has_scrollbar colour cliloc_id @args@'' || Places some localised HTML text on to the page, with arguments to the cliloc (multiple arguments separated by @).
|}

===Text===
The text section of the dialog simply lists the different text strings used in the dialog's layout. When using dialog elements that represent text, such as ''text'' or ''htmlgump'', an index into the TEXT block will be specified so that the client knows which text to actually display on that dialog element. This dialog section is optional, and may be omitted if there are no text elements on the dialog or if the newer dialog text elements, such as ''dtext'' or ''dhtmlgump'', are used because their text string is specified in the layout and Sphere will automatically populate the TEXT block for you.

<tt>
[DIALOG ''defname'' TEXT] 
''string1'' 
''string2'' 
''string3'' 
</tt>

===Buttons===
This section contains button triggers that fires when the client presses a certain button on the dialog. There are two ways that a button press can be handled, the syntaxc for both is shown below:

<tt>
[DIALOG ''defname'' BUTTON] 
ON=''button_id'' 
    ''script'' 
 
ON=''button_id_start'' ''button_id_end'' 
    ''script'' 
</tt>

The first "<tt>ON=''button_id''</tt>" will handle the button press for the button with the matching ID, the second will handle any button press where the ID is between ''button_id_start'' and ''button_id_end''.

'''Note:''' If the client cancels the dialog by right clicking it, the trigger for button 0 will be fired.

Inside the button triggers there are some arguments passed in that aren't available in normal functions and triggers. The following table describes each argument passed in to dialog button triggers:

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Description'''
|-
| [[ARGCHK]] || Returns the number of selected checkboxes/radio buttons.
|-
| [[ARGCHK]][''id''] || Returns 1 if the checkbox/radio button with a specified ID was pressed down.
|-
| [[ARGCHKID]] || The ID of the first selected checkbox/radio button, or -1 if none were selected.
|-
| [[ARGN1]] || The ID of the button pressed.
|-
| [[ARGTXT]] || Returns the number of text fields submitted.
|-
| [[ARGTXT]][''id'']] || Returns the submitted text for the text field with the specified ID.
|}

==Examples==
<spherescript>
//
// Simple travel dialog from default script pack.
//
[DIALOG d_TravelTown]
0, 0
resizepic 0 0 3600 215 200
page 0
text 40 17 0 0
text 40 37 1152 1
text 40 57 1152 2
text 40 77 1152 3
text 40 97 1152 4
text 40 117 1152 5
text 40 137 1152 6
text 40 157 0 7
button 20 40 1209 1210 1 0 1
button 20 60 1209 1210 1 0 2
button 20 80 1209 1210 1 0 3
button 20 100 1209 1210 1 0 4
button 20 120 1209 1210 1 0 5
button 20 140 1209 1210 1 0 6

[DIALOG d_TravelTown TEXT]
Which Town?
Britain
Serpent's Hold
Cove
Vesper
Bucaneer's Den
Papua

[DIALOG d_TravelTown BUTTON]

ON=0
SYSMESSAGE Menu Aborted

ON=1 //BRITAIN
SRC.GO 1427,1697,0

ON=2 //SERPENTS HOLD
SRC.GO 3009,3363,15

ON=3 //COVE
SRC.GO 2264,1202,0

ON=4 //VESPER
SRC.GO 2892,686,0

ON=5 //BUCANEER'S DEN
SRC.GO 2733,2160,0

ON=6 //PAPUA
SRC.GO=5726,3205,-3
</spherescript>

[[Category: Reference Compendium]]
[[Category: Definitions]]

Category:Statements

2009-07-11T09:14:40Z

Taro:

{| border="1" cellspacing="4" cellpadding="4"
| '''Statement''' || '''End Statement''' || '''Description'''
|-
| [[BEGIN]] || END || Groups a set of lines together, for use with [[DORAND]] and [[DOSWITCH]] statements.
|-
| [[DORAND]] ''line_count'' || ENDDO || Executes a random line of code within the block.
|-
| [[DOSWITCH]] ''line_number'' || ENDDO || Executes the specified line of code within the block.
|-
| [[FOR]] ''start end'' || ENDFOR || Loops through the block of code
|-
| [[FORCHARLAYER]] ''layer_id'' || ENDFOR || Loops through all items that a character has equipped on a specified layer.
|-
| [[FORCHARMEMORYTYPE]] ''memory_flags'' || ENDFOR || Loops through all memory items on a character that have one of the specified flags.
|-
| [[FORCHARS]] ''distance'' || ENDFOR || Loops through all characters within ''distance'' tiles.
|-
| [[FORCLIENTS]] ''distance'' || ENDFOR || Loops through all connected clients within ''distance'' tiles.
|-
| [[FORCONT]] ''container_uid, max_subcontainers'' || ENDFOR || Loops through all items inside a container.
|-
| [[FORCONTID]] ''item_id, max_subcontainers'''' || ENDFOR || Loops through all items inside a container with a specified [[BASEID]]
|-
| [[FORCONTTYPE]] ''type, max_subcontainers'' || ENDFOR || Loops through all items inside a container with a specified [[TYPE]]
|-
| [[FORINSTANCES]] ''defname'' || ENDFOR || Loops through all instances of characters or items with the specified [[BASEID]]
|-
| [[FORITEMS]] ''distance'' || ENDFOR || Loops through all items within ''distance'' tiles.
|-
| [[FOROBJS]] ''distance'' || ENDFOR || Loops through all items and players within ''distance'' tiles.
|-
| [[FORPLAYERS]] ''distance'' || ENDFOR || Loops through all players (online and offline) within ''distance'' tiles.
|-
| [[IF]] ''condition'' [[IF|ELIF]] ''condition'' || ENDIF || Executes the block of code if ''condition'' is true.
|-
| [[WHILE]] ''condition'' || ENDWHILE || Loops through the block of code whilst ''condition'' is true.
|}

[[Category: Reference Compendium]]
[[Category: Scripts]]