# Advanced Point Distribution System

### Step-by-Step Setup Guide

#### 1. Import the Collectible Point Part

{% file src="/files/FsH8C84kNNACNVuOiK4Y" %}

The ready to use part contains:

1. Point part with mesh & texture
2. Sound to be played when user collide with the part (collect it)
3. Server-side script to handle the collision & sending of point to the player
4. Part's customer attributes to be used when sending the point on the Giftoin Platform the the player

#### 2. Set Up Custom Attributes

1. Select your "CandyPoint" part in the Explorer.
2. In the Properties window, scroll down to the Attributes section.
3. Set values for each attribute:
   * PointQuantity: Enter the number of points this collectible is worth (e.g., 10)
   * PointId: Enter a unique identifier for this type of point (e.g., "candy\_point")
   * CampaignId: Enter the campaign identifier (e.g., "halloween\_2024")

#### 3. Test and Replicate

1. Play test your game to ensure the point collection works as expected.
2. Once confirmed, you can duplicate the "CandyPoint" part and distribute it throughout your game.
3. Adjust the attributes for each instance as needed (e.g., different point values or IDs for different locations).

#### 4. Final Considerations

* Ensure the GiftoinModule is properly set up with the correct API endpoints and authentication.
* Consider creating a system to dynamically spawn these points in your game.
* Implement a user interface to display collected points to players.
* Set up proper error handling and logging for the API calls.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.giftoin.org/platform-guides/roblox/additional-example-use-cases/advanced-point-distribution-system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
