Controllers

Server Enviroment
Client Enviroment

Overview

Controllers are the core of your application, as they are responsible for handling incoming events/RPCs and returning responses to the client when RPC is used. Controllers are classes that are decorated with the @Controller() decorator. A single controller can have multiple event/RPC handlers, and different event/RPC handlers can perform different actions.

+
+
import { Controller } from '@altv-mango/server'; 
//  or
import { Controller } from '@altv-mango/client'; 

@Controller()
export class DeliciousMangoController {
    @Inject() private readonly db: MyDatabaseService;

    @OnPlayerConnect()
    public onPlayerConnect(@Player() player: alt.Player) {
        console.log(`${player.name} wants to eat a mango!`);
    }

    @OnRequest('getMango')
    public getMango(@Param('id') id: number) {
        return db.getMango(id);
    }
}
typescript

Event/RPC Handlers

Passing Arguments

By default, in alt:V event emitting you can pass multiple arguments because it uses the spread operator. However, in the Mango framework, you can only pass one argument. If you want to pass multiple arguments, you should use an object or an array.

// alt:V
alt.Events.emit('myEvent', arg1, arg2, arg3);
// Mango Framework
eventService.emit('myEvent', { arg1, arg2, arg3 });
typescript

It is similar to the POST request, where you can define the body of the request.

fetch('http://localhost:3000/myEvent', {
    method: 'POST',
    body: JSON.stringify({ arg1, arg2, arg3 }),
    headers: {
        'Content-Type': 'application/json',
    },
});
typescript

Events

Event handlers are methods decorated with decorators like @On, @Once. Event handlers are used to handle incoming events from server/client.

RPCs

RPCs are methods decorated with decorators like @OnRequest, @OnServerRequest that are used to handle incoming RPCs from server/clients and return responses to the requester.

Suggest changes to this page
Last update at: 2024/06/18 19:03:08