编辑“︁Marauroa 3.8”︁（章节）

== Protocol extensions ==

=== Details in character list ===

; Summary : The character list on login now contains the RPObject with details about all owned characters
; Reason for change : Player should have more information in the choose character dialog.
; Impact on Marauroa users : A new optional method onAvailableCharacterDetails in ClientFramework will provide the additional data, onAvailableCharacters is still called so old programs will continue to work without adjustments.
; Details : When the client uses at least protocol version 32 on login, the server will include details of the characters belonging to that account.

[[Image:Stendhal_choose_character.png]]

=== Maps attributes ===

; Summary : There is a new map datatype that is capable of storing key value pairs.
; Reason for change : There are many kinds of map like data structures in Stendhal (buddy list, ignore list, quest states, visited zones, ...). The previous way of using an RPSlot with exactly one RPObject was inconvenient. 
; Impact on Marauroa users : There are new methods in RPObject to work with the maps
; Details : To use a map attribute you need to define an attribute with type map in the RPClass. It is done the same way as ''normal'' attributes for Strings or Integers. Here a short example on how to define a map attribute as it is done in Stendhal for the buddy list:

 player.addAttribute("buddies", Type.MAP, Definition.PRIVATE);

Afterwards you can access the map with several methods defined in RPObject to put or get values. To put a key value pair in a certain map you need to call the put method for maps:
 rpobject.put(mapname, key, value);

To get a value stored for a key in a map you need to use the get method for maps:
 rpobject.get(mapname, key);

The put and get methods provide methods to store/access String, Integer and Boolean values like they are provided for the existing attributes.
 public void put(String mapname, String key, String value)
 public void put(String mapname, String key, int value)
 public void put(String mapname, String key, boolean value)
 public String get(String mapname, String key)
 public int get(String mapname, String key)
 public boolean get(String mapname, String key)

If you need to check if a certain map is present in a RPObject you can to this by calling
 rpobject.hasMap(mapname)

It returns true if within the RPObject has a map with mapname and false if not.

To access the map as a whole thing it is possible to obtain a copy via the getMap method.
 Map<String, String> theWholeMap = rpobject.getMap(mapname);

As a convenience method RPObject can return all maps put together in one map:
 public Map<String, Map<String, String>> maps()

An example usage of the maps can be found in the [http://arianne.cvs.sourceforge.net/viewvc/arianne/stendhal/src/games/stendhal/server/entity/player/Player.java?revision=1.284.2.1&view=markup Player] class of [[Stendhal]]. The buddies and their online statusses of a player are stored as a map within the player object. The class [http://arianne.cvs.sourceforge.net/viewvc/arianne/stendhal/src/games/stendhal/server/entity/player/PlayerRPClass.java?revision=1.164&view=markup PlayerRPClass] shows how to define a map attribute in a RPClass.