Treasure Island Host API Reference

Copy Base URL: https://genacnh.com/api Content-Type: application/x-www-form-urlencoded | application/json Accept: application/json

Copy X-Bot-Token: gen_bot_tok_1a2b3c4d5e6f7g8h9i0j...

Copy const { SlashCommandBuilder, EmbedBuilder, ActionRowBuilder, ButtonBuilder, ButtonStyle } = require('discord.js'); module.exports = { data: new SlashCommandBuilder() .setName('islands') .setDescription('View live open Animal Crossing treasure islands & Dodo codes') .addStringOption(option => option.setName('category') .setDescription('Filter island by item category') .addChoices( { name: 'All Categories', value: 'all' }, { name: 'DIY Recipes', value: 'diys' }, { name: 'Materials & Gold', value: 'materials' }, { name: 'Max Bells', value: 'maxbells' }, { name: 'Furniture Sets', value: 'furniture' }, { name: 'Villagers in Boxes', value: 'villagers' } ) ), async execute(interaction) { await interaction.deferReply(); const category = interaction.options.getString('category') || 'all'; try { const res = await fetch(`https://genacnh.com/api/v1/public/active-hosts?category=${category}&type=free&limit=5`); const data = await res.json(); if (!data.success || !data.hosts || data.hosts.length === 0) { return interaction.editReply('🏝️ **All treasure islands are currently full or restarting.** Check live queue: https://genacnh.com/islands.php'); } const embed = new EmbedBuilder() .setTitle('🏝️ GenACNH Live Public Treasure Islands') .setDescription(`Found **${data.total_active_hosts}** online public islands. Fly via Dodo Code at your airport!`) .setColor(0x2dd4bf) .setThumbnail('https://genacnh.com/images/logo/GenACNH_Logo.png') .setTimestamp() .setFooter({ text: 'Powered by GenACNH Island Automation Network', iconURL: 'https://genacnh.com/images/logo/GenACNH_Logo.png' }); data.hosts.forEach(isl => { const statusDot = (isl.available_slots > 0) ? '🟢 OPEN' : '🔴 FULL'; embed.addFields({ name: `${isl.name} · ${isl.category_label}`, value: `🔑 **Dodo Code:** \`${isl.dodo_code}\`\n👥 **Visitors:** ${isl.current_visitors}/${isl.max_visitors} (${statusDot})\n📖 *${isl.description}*`, inline: false }); }); const row = new ActionRowBuilder().addComponents( new ButtonBuilder() .setLabel('View Live Map Directory') .setStyle(ButtonStyle.Link) .setURL('https://genacnh.com/islands.php') ); await interaction.editReply({ embeds: [embed], components: [row] }); } catch (err) { console.error('GenACNH API Error:', err); await interaction.editReply('❌ Failed to fetch treasure island status. Please try again in a few seconds.'); } } };

Copy const { Client, GatewayIntentBits, EmbedBuilder } = require('discord.js'); const client = new Client({ intents: [GatewayIntentBits.Guilds] }); const STATUS_CHANNEL_ID = "YOUR_DISCORD_CHANNEL_ID_HERE"; let statusMessageId = null; async function updateIslandStatusChannel() { try { const channel = await client.channels.fetch(STATUS_CHANNEL_ID); if (!channel) return; const res = await fetch("https://genacnh.com/api/v1/public/active-hosts?type=free&limit=10"); const data = await res.json(); const embed = new EmbedBuilder() .setTitle("🏝️ Live Animal Crossing Treasure Islands Directory") .setDescription(`Real-time Dodo Codes for open automated SysBot islands.\n*Updated every 30 seconds.*`) .setColor(0x10b981) .setThumbnail("https://genacnh.com/images/logo/GenACNH_Logo.png") .setTimestamp() .setFooter({ text: "GenACNH Island Automation Network" }); if (data.hosts && data.hosts.length > 0) { data.hosts.forEach(isl => { embed.addFields({ name: `📍 ${isl.name} (${isl.category_label})`, value: `🛫 **Dodo:** \`${isl.dodo_code}\` | **Queue:** ${isl.current_visitors}/${isl.max_visitors} (${isl.status})`, inline: true }); }); } else { embed.addFields({ name: "Offline", value: "All islands are currently cycling. Please check back shortly!" }); } if (!statusMessageId) { const msg = await channel.send({ embeds: [embed] }); statusMessageId = msg.id; } else { const msg = await channel.messages.fetch(statusMessageId); await msg.edit({ embeds: [embed] }); } } catch (e) { console.error("Status channel update error:", e); } } client.once('ready', () => { console.log(`Bot logged in as ${client.user.tag}`); updateIslandStatusChannel(); setInterval(updateIslandStatusChannel, 30000); // Poll every 30s }); client.login("YOUR_DISCORD_BOT_TOKEN_HERE");

Copy import discord from discord import app_commands from discord.ext import commands import aiohttp class IslandCog(commands.Cog): def __init__(self, bot): self.bot = bot @app_commands.command(name="islands", description="Display live ACNH treasure islands & Dodo codes") @app_commands.describe(category="Filter by item theme (e.g. diys, materials, maxbells, all)") async def islands(self, interaction: discord.Interaction, category: str = "all"): await interaction.response.defer() url = f"https://genacnh.com/api/v1/public/active-hosts?category={category}&type=free&limit=5" async with aiohttp.ClientSession() as session: async with session.get(url) as resp: if resp.status != 200: return await interaction.followup.send("❌ Could not connect to GenACNH API.") data = await resp.json() hosts = data.get("hosts", []) if not hosts: return await interaction.followup.send("🏝️ No public islands currently open. Check https://genacnh.com/islands.php") embed = discord.Embed( title="🏝️ GenACNH Live Treasure Islands", description=f"Showing **{len(hosts)}** active automated islands. Fly via Dodo Code!", color=0x2DD4BF ) embed.set_thumbnail(url="https://genacnh.com/images/logo/GenACNH_Logo.png") embed.set_footer(text="Powered by GenACNH Island Automation Network", icon_url="https://genacnh.com/images/logo/GenACNH_Logo.png") for isl in hosts: embed.add_field( name=f"{isl['name']} ({isl['category_label']})", value=f"🔑 **Dodo:** `{isl['dodo_code']}`\n👥 **Capacity:** {isl['current_visitors']}/{isl['max_visitors']} ({isl['status']})\n🌐 [View on GenACNH]({isl['web_url']})", inline=False ) await interaction.followup.send(embed=embed) async def setup(bot): await bot.add_cog(IslandCog(bot))

Copy import Foundation struct GenACNHResponse: Codable { let success: Bool let totalActiveHosts: Int let freePublicHosts: Int let hosts: [IslandHost] enum CodingKeys: String, CodingKey { case success case totalActiveHosts = "total_active_hosts" case freePublicHosts = "free_public_hosts" case hosts } } struct IslandHost: Codable, Identifiable { let id: Int let name: String let category: String let categoryLabel: String let description: String let dodoCode: String let isFree: Bool let status: String let currentVisitors: Int let maxVisitors: Int let availableSlots: Int let webUrl: String enum CodingKeys: String, CodingKey { case id, name, category, description, status case categoryLabel = "category_label" case dodoCode = "dodo_code" case isFree = "is_free" case currentVisitors = "current_visitors" case maxVisitors = "max_visitors" case availableSlots = "available_slots" case webUrl = "web_url" } } func fetchActiveTreasureIslands(completion: @escaping ([IslandHost]?) -> Void) { guard let url = URL(string: "https://genacnh.com/api/v1/public/active-hosts?type=free&status=open") else { return } URLSession.shared.dataTask(with: url) { data, _, error in guard let data = data, error == nil else { completion(nil) return } let response = try? JSONDecoder().decode(GenACNHResponse.self, from: data) DispatchQueue.main.async { completion(response?.hosts) } }.resume() }

Copy import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.withContext import okhttp3.OkHttpClient import okhttp3.Request import org.json.JSONObject class GenACNHRepository { private val client = OkHttpClient() suspend fun getActiveTreasureIslands(category: String = "all"): String = withContext(Dispatchers.IO) { val request = Request.Builder() .url("https://genacnh.com/api/v1/public/active-hosts?category=$category&type=free") .header("User-Agent", "ACNHCompanionApp/1.0") .build() client.newCall(request).execute().use { response -> if (!response.isSuccessful) throw Exception("HTTP ${response.code}") response.body?.string() ?: "" } } }

Copy // Fetch open public treasure islands from GenACNH async function getLiveTreasureIslands(category = 'all') { try { const response = await fetch(`https://genacnh.com/api/v1/public/active-hosts?category=${category}&type=free&status=open`); const data = await response.json(); if (data.success) { console.log(`Found ${data.total_active_hosts} online islands:`, data.hosts); return data.hosts; } } catch (err) { console.error("Failed to load GenACNH active hosts:", err); } return []; }

Copy using System; using System.Collections.Generic; using System.Net.Http; using System.Threading.Tasks; public class GenACNHHostClient { private static readonly HttpClient client = new HttpClient(); private const string BotToken = "YOUR_BOT_TOKEN_HERE"; public static async Task UpdateIslandStatusAsync(string islandName, string dodoCode, string category = "all_items", string bannerUrl = "") { client.DefaultRequestHeaders.Clear(); client.DefaultRequestHeaders.Add("X-Bot-Token", BotToken); client.DefaultRequestHeaders.UserAgent.ParseAdd("SysBot.GenACNH/1.0"); var values = new Dictionary { { "island_name", islandName }, { "dodo_code", dodoCode }, { "category", category }, { "banner_url", bannerUrl }, { "is_online", "1" }, { "is_paid", "0" }, { "max_visitors", "7" } }; var content = new FormUrlEncodedContent(values); var response = await client.PostAsync("https://genacnh.com/api/v1/island/update", content); string result = await response.Content.ReadAsStringAsync(); Console.WriteLine($"[GenACNH API] {result}"); } }

Copy import requests headers = { "X-Bot-Token": "YOUR_BOT_TOKEN_HERE", "User-Agent": "SysBot.GenACNH/1.0" } payload = { "island_name": "Starry Beach", "dodo_code": "8M2KP", "category": "diys", "banner_url": "https://i.imgur.com/example-banner.jpg", "is_online": 1, "max_visitors": 7 } res = requests.post("https://genacnh.com/api/v1/island/update", headers=headers, data=payload) print(res.json())

Copy curl -X POST "https://genacnh.com/api/v1/island/update" \ -H "X-Bot-Token: YOUR_BOT_TOKEN_HERE" \ -H "User-Agent: SysBot.GenACNH/1.0" \ -F "island_name=Nook Haven" \ -F "dodo_code=5K9LM" \ -F "category=all_items" \ -F "banner_url=https://i.imgur.com/example-banner.jpg" \ -F "is_online=1"