Maniaplanet Forum

Slig wrote:Btw the #settings values can be added to the list of the changes that managers/controllers could announce to others.

The_Big_Boo wrote:Btw, isn't MapListModified enough for maps? Or are there methods which doesn't trigger it?

Anyway, as it's not a request nor an answer, I think it needs a third message type. It also needs a exhaustive list of methods implying these calls, especially for ServerOptions and GameInfos because they can be changed atomically. I'll make a sum up later with the requirements.

it is completely useless, isn't it? Actions for starting stopping rebooting and settin permissions are useful

Very good ideas reaby, I will start in MPAseco with it soon!

• Identify(string name, [string version], [array methods])
  - Set the name of this controller (does not have to be unique, eg: smart or aseco), optional version, and a list of methods. Returns this controller's ID.
• GetRpcClients()
  - Returns a list of all XML-RPC clients connected (array of ID's? or array of rpc clients struct)
• GetRpcClientInfo(int id)
  - Returns a struct of the rpc client.
• StopRpcClient(int id)
  - Closes the connection to that the rpc client with id (sends `Close` callback to that client first?)
• RpcSend(int target, string method, [array args])
  - Calls a method on the rpc client with the id of `target`. Returns a request id.
• RpcBroadcast(string AuthenticationLevel, string method, [array args])
  - Calls a method on all connected rpc clients with >= authentication level, except it self. Returns request id.
• RpcRespond(int requestId, bool succcess, [array params])
  - Respond to RpcCall()

• .RpcMethodCall(int requestId, int callerId, string method, array args)
  - Sent to the target client from a RpcSend()
• .RpcMethodReponse(int requestId, bool success, array params)
  - Sent to the sender of the request with the id `RequestId`.
• .RpcClientConnect(int id)
  - Sent to all rpc clients (kinda like PlayerConnect)
• .RpcClientDisconnect(int id)
  - Sent to all rpc clients (kinda like PlayerDisconnect)
• .RpcClientChanged(Struct SRpcClient)
  - Sent when info about the client changed (name, version, methods).

struct SRpcClient {
    string Name,
    string Version,
    array Methods,
    bool CallbacksEnabled,
    string AuthenticationLevel
}

1. 2: (connects)
2. 1: Receives callback: RpcClientConnect(2)
3. 2: Calls method: Authenticate("SuperAdmin", "SuperAdmin", "SuperController", "0.9.1", array("reboot", "resync"))
4. 1: Receives callback: RpcClientChanged(+some struct+)
5. 2: Calls Method: EnableCallbacks()
6. 2: Calls Method: GetRpcClients() client 2 now knows that client 1 accepts the methods `reboot` and `resync`.

1. 1: Calls method: RpcSend(2, "resync"); Gets the RequestId... eg: 192.
2. 2: Receives callback: .RpcMethodCall(192, 1, "resync", []); RequestId: 192, method: "resync", no arguments.
3. 2: Calls method: RpcRespond(192, true) - responds with success, and then resyncs everything
4. 1: Receives callback: .RpcMethodResponse(192, true, [])