Reference des fonctions
Godot 4 · GDScript · Groups & clans
list_group_requests
Lists join requests, incoming (to review) or outgoing (your own).
Asynchronous (result via signal)
Signature
list_group_requests(direction: String = "incoming", status: String = "pending", limit: int = 50) -> voidWhat it does
POSTs /groups/requests/list. requests = Array of { id, direction, group_id, group_name, player, status, message, created_at, ... }. Returns [] when there is no active session.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| direction | String | "incoming" | "incoming" (requests to your group; needs can_review_requests) or "outgoing" (your own requests). |
| status | String | "pending" | Filter: pending / accepted / declined / cancelled / expired. Any other value is rejected with a 400. |
| limit | int | 50 | Max results, clamped to 1-100. |
How to call it
Connect group_requests_listed first, then call list_group_requests(). The "incoming" direction needs the can_review_requests permission. Use the returned id with respond_group_request() or cancel_group_request().
Result signal: group_requests_listed(requests: Array)
Example
Gamdato.group_requests_listed.connect(_on_reqs)
Gamdato.list_group_requests("incoming") # -> group_requests_listed
func _on_reqs(requests: Array) -> void:
for r in requests:
print("%s wants to join" % r.player.player_name)Use cases
- Show leaders the pending applications to review.
- Let a player track the status of requests they sent.