Documentation / Giveaways

Giveaways

Discord and/or in-game giveaways, AP-… code and exports. Premium plan.

Giveaways with a Discord button, scripts/missions or both. Each giveaway has an AP-… code for AddGiveawayEntry. Premium plan · WebLogs ≥ 9.3.

Setup

  1. 1My servers → DiscordBot → Connect (if you use Discord).
  2. 2My servers → Giveaways: enable the module, channel and item delivery.
  3. 3Giveaways menu → New → options → save (copy the AP-…) → Activate / publish.
  4. 4Scripts: paste the AP-… into your resource and call AddGiveawayEntry.
OptionWhat for
Start / endOptional start (empty = on activation). End required; start < end
Enter via Discord / gameOne, the other or both
Post Discord messageOFF = activates the giveaway without posting a message to the channel
Announce winnersOFF = doesn’t post the winners message
Re-entry (hours)Discord: 0 = once; e.g. 3 = another ticket every 3 h
RerollManual delivery and the ability to change the winner
Several tickets from the same Discord increase the odds; in the draw they can only win once. Staff: View / Manage giveaways permissions.

Exports (Adictos_WebLogs)

Identity by Rockstar licence. Discord is optional (if present, announcements use a Discord mention; if not, the name from Customisation). Inactive giveaway → AddGiveawayEntry is silently ignored.

exports['Adictos_WebLogs']:AddGiveawayEntry(src, 'AP-XXXXXXXX')

exports['Adictos_WebLogs']:IsGiveawayActive('AP-XXXXXXXX', function(active, info)
    if active then
        exports['Adictos_WebLogs']:AddGiveawayEntry(src, 'AP-XXXXXXXX')
    end
end)

exports['Adictos_WebLogs']:GetGiveawayStatus('AP-XXXXXXXX', function(info) end)

Prizes

  • Discord VIP — requires a linked Discord and a connected bot; the bot’s role must be above the VIP role.
  • Item — command / on connect / storage (not duplicated). Optional expiry in days (0 = no limit). Works without Discord.
  • Announcement only — you deliver it by hand.

Troubleshooting

ProblemWhat to check
Discord button doesn’t respondDiscordBot → Connect again; text channel + bot permissions
VIP isn’t assignedBot role above the VIP role; notifications bell
Item doesn’t arriveWebLogs, active delivery method, linked Discord
Missions without a ticketActive giveaway + “From the game” + AP code in Quest + WebLogs ≥ 9.3 + linked Discord