AutoSVF documentation

Your AutoSVF account

Create a free account in the panel. Confirm your email and you get access to all three services: serverfile installation, the autopatcher and the server website.

• Forgot your password: on the sign-in page, “Forgot your password?”. The link is valid for one hour.
• Payments: installations, autopatcher plans and website plans are paid with PayPal or card. Nothing renews automatically.
• Panel language: Romanian or English, from the corner of the page.

Installing a serverfile

The panel installs a Metin2 serverfile (game and mysql) on a FreeBSD 13 or 14 server over SSH. Enter the IP and login details, pick the serverfile and the installation runs by itself; at the end you get the passwords.

• Installing is free if the server provider has authorised the IP; otherwise you buy installations in the panel.
• Login details are not kept after the installation.

Step by step, from the VPS to the first in-game login: Metin2 server guide. Available serverfiles: catalogue.

The autopatcher

Build an autopatcher for your players in the panel: it keeps the client up to date, repairs files and starts the game. The client files stay on your host; we sign the list and generate the executable.

The full guide, with screenshots and the folder layout: Autopatcher guide. Overview and plans: Autopatcher.

Website & Item Shop: first steps

Panel → Website & Item Shop → New site. Choose the server name, the address (name.autosvf.ro) and the theme. The site is online immediately on the free plan; from the Plan tab you can try the paid plan for free.

The site editor groups its tabs into five areas: Overview (statistics), Site (settings, look, home page, domain), Content (news, pages, wiki, events, downloads), Game (game database, players, in-game notices, tickets, logs, admin log) and Shop (item shop, wheel, coupons, market, referrals, payments).

Connecting the game database

The Game & accounts tab. Without a connection the site works, but without accounts, rankings or an item shop.

FreeBSD server (recommended)

1. Enter the game server IP and press Generate the script.
2. Upload autosvf-cms.sh to /root and run it as root: sh /root/autosvf-cms.sh.
3. The script creates a MySQL user that can only connect from the AutoSVF IP, with rights only on the tables in use: accounts, characters, guilds, the Item Shop storage, the item and monster tables, in-game notices and the logs (read only).
4. Back in the panel: Test the connection.

Manual

For other servers: host, port, user and password. Use a user with limited rights, not root.

The domain

The Domain tab. You get the name.autosvf.ro subdomain from the start, with SSL.

Your own domain

1. Enter the domain and press Add the domain.
2. At the company you bought the domain from, add: A @ → the IP shown in the panel and CNAME www → autosvf.ro.
3. Once DNS updates (minutes to hours), the domain activates itself with a certificate; you can also press Check now.

Check the link

The button checks from our server: DNS, whether the address opens your site, the certificate and the HTTP to HTTPS redirect. Each problem comes with what to do.

Look and content

• Look: the theme (10, in three layouts), logo, background, icon, colour and, on the paid plan, your own CSS.
• Home page: title, tagline, rates, countdown to launch, a “Why play” section.
• News and pages: with categories (announcement, event, update, maintenance); update news also show up as patch notes. Pages can appear in the menu.
• Languages: the main language and, on the multi-language plan, others (Romanian, English, German, Turkish, Polish, Hungarian, Spanish, Italian). News and pages can be in one language or all.
• Events: one-off or repeating, with a duration; optionally an in-game notice when they start.
• Downloads: your autopatcher, links to the client, minimum requirements and, optionally, a VirusTotal scan.

Wiki

The Wiki tab has two parts:

• Articles written by your team, in categories, with images.
• The game database: turn it on and press Update now from the game. Items (bonuses, attack, classes, upgrades) and monsters (level, HP, rank) are copied from the game and updated daily.

Drops are not in the database: upload mob_drop_item.txt and special_item_group.txt from the server’s locale folder. Hide test or unreleased items by vnum or range (e.g. 90000-90999).

Item shop

1. Currencies: in Settings, choose the columns of the account table (usually coins for MD and jcoins for JD).
2. Categories and items: search by name in item_proto, price, quantity, sockets and bonuses, quantity discounts, stock, per-account limit, badges.
3. Import: if you had an old CMS, “Import the item shop” and “Import the news”.
4. Cashback: X% of MD spent comes back as JD.

Items arrive in the in-game Item Shop storage. If delivery fails, the coins go back automatically.

Items with bonuses

If the server’s item_award table has no bonus columns, items with bonuses are delivered straight into the Item Shop storage: only when the player has been offline for at least 30 minutes and with IDs outside ITEM_ID_RANGE from the db process conf.txt, so there are no dupes. Turn it on in the “Items with bonuses” card. If the player is in game when buying, the item arrives by itself after they log out.

Wheel, coupons, market, referrals

• Wheel of fortune: cost, prizes with chances, a daily limit.
• Coupons: a code for coins or an item, maximum uses, expiry.
• Market: players sell each other items bought with “web depot” delivery, with your fee.
• Referrals: every player has a link; the reward comes when the friend reaches your chosen level, plus, optionally, a share of their purchases. Suspicious referrals (same IP) wait for your approval.

Player payments

The Payments tab: coin packages (coins, bonus %, price) and payment methods. The money goes straight to you.

• PayPal: developer.paypal.com → Apps & Credentials → the Live app → Client ID and Secret. The webhook address is in the panel (/plata/paypal/webhook). PayPal does not accept RON.
• Stripe: the secret key and, for the webhook (/plata/stripe/webhook), the whsec_ secret.
• Bank transfer: beneficiary, IBAN, bank; confirm orders in the panel once you see the money.

Players and the game

• Players: look up an account; see its status, coins and characters; ban it (with reason and evidence) or lift the ban; give coins or items, with a reason kept in the history.
• In-game notices: a notice or an event (e.g. exp_event), now or scheduled. Works if the server source reads the metin2_runup.send_notice and send_event tables.
• Tickets: players write from the site, the team replies from the panel, the player gets an email.
• Logs: search the log database: logins with IP, items, trades, GM commands and more, with filters.
• Game team: the public page with the GMs from common.gmlist.

Site team and statistics

Admins: add other AutoSVF accounts by email, with separate permissions (settings, content, shop, payments, tickets, players). The plan, the team and deleting the site stay yours. Every change appears in the Admin log.

Statistics: visitors and page views, new accounts, purchases, tickets, the most visited pages and revenue, over 7, 30 or 90 days. No cookies and no stored IPs.

Plans and billing

See what each plan includes on the Website & Item Shop page. You pay for 30 days at a time from the Plan tab, with no automatic renewal. When it expires the site moves to the free plan and your data stays.

Common problems

• “Test the connection” fails: MySQL only listens locally (see bind-address), the firewall blocks the port, or the script was not run after the latest update.
• The domain does not open the site: press “Check the link” in the Domain tab and follow what it says.
• The payment went through but no coins arrived: Payments tab → the order → Deliver again or Check.
• An item with bonuses did not arrive: the player must have been offline for at least 30 minutes; the queue is in the “Items with bonuses” card.
• Notices do not show in game: the server source does not read send_notice.

Anything else? Write to contact@autosvf.ro.