Forum EvAnA

Help desk

Guides & support

How TopSite, postback, roles, tickets and releases work — then open a private ticket if you still need staff.

Guide

First time here

  1. Open General Discussion → sticky Introduce yourself!.
  2. Reply with your name/nickname and why you are here (player, developer, files, server owner…).
  3. Say hi once in the Shoutbox on the home page.
  4. After both steps you can create threads and reply anywhere on the forum.

Mods/admins skip this gate. Active members with existing posts are not blocked.

Guide

Create a TopSite

  1. Log in → TopSites → Add server.
  2. Fill title, website URL, Season, Experience, Drop, Difficulty. Description uses the visual editor. Logo is free; banner is VIP.
  3. Add Discord invite if you have one.
  4. Domain rule: one free listing per root domain. Another listing on the same domain costs €5 (5 coins).
  5. Submit → auto-approved and ranked immediately (Opening soon stays in the countdown list until launch).

Rating matters: ranking uses votes × quality. Many low star reviews sink you even with huge vote counts — keep players happy.

Fake stats or vote abuse = removal. Edit anytime from your listing → Edit.

Monthly reset: ranking votes (Votes) reset on the last day of each month at 23:59. Lifetime Total stays. Countdown is on the home sidebar and TopSite page.

Guide

Buy TopSite VIP

1 coin = €1. TopSite VIP costs €5 (5 coins).

  1. Buy coins in the Coin Shop if needed.
  2. Open your server → Edit → Buy VIP · €5.
  3. VIP unlocks: ranking highlight, custom banner, Vote Postback API (PHP / Node / C++).

Domain unlock is separate: €5 / 5 coins when the same domain is already listed.

Guide

Vote Postback

TopSite VIP required (€5) for Postback API and custom banner. Free listings still get votes — the rewards API is VIP-only.

  1. Buy VIP on Edit listing, then open the Postback box.
  2. Copy your SecretKey (keep it private).
  3. Pull API (cron every 1–5 min): https://forum.evana.cc/topsites/postback?SecretKey=YOUR_KEY
  4. Optional query flags: &claim=0 peek without marking claimed · &username=CharName check one player (12h window).
  5. Push (optional): set an HTTPS URL — on each vote we POST form fields user, ip, timestamp, signature. Respond with plain text SUCCESS.

Push signature = HMAC-SHA256 of lines ip=… + timestamp=… + user=… (sorted keys, joined by newline) using SecretKey.

PHP — pull + rewardcron / CLI
<?php
declare(strict_types=1);

$key = 'YOUR_SECRET'; // from Edit → Postback
$api = 'https://forum.evana.cc/topsites/postback?SecretKey=' . rawurlencode($key);

$ch = curl_init($api);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$raw = curl_exec($ch);
$code = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($raw === false || $code !== 200) {
    fwrite(STDERR, "Postback failed HTTP {$code}\n");
    exit(1);
}

$data = json_decode($raw, true);
if (!($data['ok'] ?? false)) {
    fwrite(STDERR, ($data['error'] ?? 'unknown') . "\n");
    exit(1);
}

foreach ($data['votes'] ?? [] as $v) {
    $user = (string) ($v['username'] ?? '');
    $ip   = (string) ($v['ip'] ?? '');
    if ($user === '') continue;
    // giveReward($user, $ip);  // your game DB / cash shop
    echo "Rewarded {$user} from {$ip}\n";
}
PHP — push endpointrespond SUCCESS
<?php
declare(strict_types=1);

$secret = 'YOUR_SECRET';
$user = (string) ($_POST['user'] ?? '');
$ip = (string) ($_POST['ip'] ?? '');
$ts = (string) ($_POST['timestamp'] ?? '');
$sig = (string) ($_POST['signature'] ?? '');

$payload = ['ip' => $ip, 'timestamp' => $ts, 'user' => $user];
ksort($payload);
$base = [];
foreach ($payload as $k => $v) { $base[] = $k . '=' . $v; }
$expect = hash_hmac('sha256', implode("\n", $base), $secret);

if (!hash_equals($expect, $sig) || $user === '') {
    http_response_code(403);
    echo 'FAIL';
    exit;
}

// giveReward($user, $ip);
header('Content-Type: text/plain');
echo 'SUCCESS';
Node.js — pullESM
import crypto from 'node:crypto';

const key = 'YOUR_SECRET';
const url = `https://forum.evana.cc/topsites/postback?SecretKey=${encodeURIComponent(key)}`;

const res = await fetch(url, { headers: { Accept: 'application/json' } });
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
if (!data.ok) throw new Error(data.error || 'postback error');

for (const v of data.votes || []) {
  const user = String(v.username || '');
  const ip = String(v.ip || '');
  if (!user) continue;
  // await giveReward(user, ip);
  console.log(`Rewarded ${user} (${ip})`);
}
Node.js — push verifyExpress
import express from 'express';
import crypto from 'node:crypto';

const app = express();
app.use(express.urlencoded({ extended: false }));
const SECRET = 'YOUR_SECRET';

app.post('/api/evana-vote', async (req, res) => {
  const user = String(req.body.user || '');
  const ip = String(req.body.ip || '');
  const timestamp = String(req.body.timestamp || '');
  const signature = String(req.body.signature || '');
  const payload = { ip, timestamp, user };
  const base = Object.keys(payload).sort()
    .map((k) => `${k}=${payload[k]}`).join('\n');
  const expect = crypto.createHmac('sha256', SECRET).update(base).digest('hex');
  if (!user || !crypto.timingSafeEqual(Buffer.from(expect), Buffer.from(signature))) {
    return res.status(403).type('text').send('FAIL');
  }
  // await giveReward(user, ip);
  res.type('text').send('SUCCESS');
});

app.listen(3000);
C++ — pull (libcurl + nlohmann/json)
#include <curl/curl.h>
#include <nlohmann/json.hpp>
#include <string>
#include <iostream>

static size_t write_cb(char* p, size_t s, size_t n, void* u) {
  auto* out = static_cast<std::string*>(u);
  out->append(p, s * n);
  return s * n;
}

int main() {
  const std::string key = "YOUR_SECRET";
  const std::string url =
    "https://forum.evana.cc/topsites/postback?SecretKey=" + key; // url-encode in production

  CURL* curl = curl_easy_init();
  std::string body;
  curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
  curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_cb);
  curl_easy_setopt(curl, CURLOPT_WRITEDATA, &body);
  curl_easy_setopt(curl, CURLOPT_TIMEOUT, 15L);
  CURLcode rc = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
  if (rc != CURLE_OK) return 1;

  auto j = nlohmann::json::parse(body);
  if (!j.value("ok", false)) return 1;
  for (auto& v : j["votes"]) {
    std::string user = v.value("username", "");
    std::string ip = v.value("ip", "");
    if (user.empty()) continue;
    // GiveReward(user, ip);
    std::cout << "Rewarded " << user << "\n";
  }
}

Rotate SecretKey from Edit if it leaks. Non-VIP SecretKeys return 403. Votes are claimed after a successful pull unless you use claim=0.

Guide

Coins & Shop

  1. Open Shop and pick a pack. Price is 1 coin = €1 (same as USD rate in checkout).
  2. Pay with PayPal, Stripe or crypto. Coins credit after the gateway confirms.
  3. Spend coins on: TopSite VIP (€5), domain unlock (€5), Advertise slots.
  4. Check balance anytime in Profile.

Need help with a payment? Open an mTicket under Billing.

Guide

Roles & Discord

  • Newbie / Member — forum, shoutbox, vote, mTicket.
  • Contributor / VIP (role) — higher visibility; VIP role can advertise.
  • Coder / Designer / Seller / Developer — release perks (bigger uploads, release badge).
  • Moderator / Super Mod — moderate forum & shoutbox.
  • Administrator — full ACP.

Set Discord tag/ID in Profile → Account. TopSite Discord invite is set on the listing Edit page (separate from your profile tag).

Some Shop products grant roles automatically after purchase.

Guide

mTicket (Help desk)

  1. Open Help desk → New ticket (login required).
  2. Choose category: Billing, License, Product, TopSite / Postback, Releases, Account / Roles, Technical, Other.
  3. Write a clear subject + message (errors, URLs, last 4 of SecretKey only — never full keys/passwords).
  4. Staff reply in the same thread. Status: Open → Answered → Awaiting reply → Closed.
  5. Find Your tickets on Profile or reopen from Help desk.

Tickets are private — only you and staff. Do not post billing issues in public forum threads.

Guide

Publish a Release

Anyone who finished first-time intro (and can post) may publish a release — Newbie / Member included. You do not need Seller.

  1. Open a Releases board → create a new topic.
  2. Write a clean description in the visual editor (features, screenshots, requirements).
  3. Attach archives (.zip / .rar / .7z) or other allowed files — they show automatically on Downloads / Releases.
  4. Ship patches with a new attachment or an updated post.

Role advantages (Seller, Developer, Coder, Designer, Mod…):

  • Larger upload limit and more files per post
  • Release / Seller badge on your profile and posts
  • Higher trust visibility in the community

No malware, cracks or stolen work — removal and ban risk for every role.

Your tickets live on Profile

Open or track mTickets from your member area. Guides stay here on Help desk.

Sign in
Premium slot before Community pulse — only 1 available Advertise here

Community pulse

Who was online

1Online now
1Last 24h
1Members

Online now 1

Seen in the last 24 hours 1