మోడ్‌ప్యాక్ రచయిత API: యాక్టివేషన్ కోడ్‌లు మరియు అప్‌డేట్‌లు

మీరు కోడ్ రాయాల్సిన అవసరం లేదు. కింద వివరించిన ప్రతిదీ ఇప్పుడు బటన్‌ల రూపంలో కూడా అందుబాటులో ఉంది: మీ మోడ్‌ప్యాక్ మీ Millida ఖాతాకు లింక్ చేయబడి ఉంటే, మీ ప్రొఫైల్‌లో “నా మోడ్‌ప్యాక్‌లు” ట్యాబ్ కనిపిస్తుంది — అక్కడ మీరు వెర్షన్‌లను అప్‌లోడ్ చేయవచ్చు, కార్డును ఎడిట్ చేయవచ్చు మరియు ల్యాండింగ్ పేజీలను నిర్మించవచ్చు. లింక్ చేయబడకపోతే — మాకు రాయండి, మేము లింక్ చేస్తాము. API అనేది తమ స్వంత CI నుండి డిప్లాయ్ చేసేవారి కోసం.

ఈ ఆర్టికల్ తమ పెయిడ్ మోడ్‌ప్యాక్‌లను తామే అమ్ముకునే మరియు సర్వర్ ఇన్‌స్టాలేషన్‌ను మాకు అప్పగించే రచయితల కోసం. కొనుగోలుదారు ఏమీ డౌన్‌లోడ్ చేయాల్సిన అవసరం లేదు: వారు ఒక కోడ్ నమోదు చేసి, డిప్లాయ్ చేయబడిన మోడ్‌ప్యాక్‌ను పొందుతారు. వారి వైపు నుండి ఇది ఎలా కనిపిస్తుందో చూడటానికి, యాక్టివేషన్ కోడ్ ద్వారా పెయిడ్ మోడ్‌ప్యాక్ చదవండి.

ప్రారంభించడానికి మీకు ఏమి కావాలి

1. మాకు మీ మోడ్‌ప్యాక్ యొక్క సర్వర్ ఆర్కైవ్ను పంపండి — రూట్‌లో mods/ ఉన్న .zip (Server Files/ వంటి ర్యాపర్ లేకుండా) లేదా .mrpack. ఆర్కైవ్ మా ప్రైవేట్ స్టోరేజ్‌లో నిల్వ చేయబడుతుంది, మరియు లింక్ బయట ఎప్పుడూ పంచుకోబడదు.
2. మాకు కోర్, గేమ్ వెర్షన్ మరియు కనీస మెమరీని చెప్పండి — మోడ్‌ప్యాక్ నడవని ప్లాన్‌లను ఫిల్టర్ చేయడానికి విజార్డ్ వాటిని ఉపయోగిస్తుంది.
3. మా నుండి ఒక మోడ్‌ప్యాక్ కీ (key, ఉదాహరణకు arcania) మరియు ఒక ఇష్యూయింగ్ టోకెన్ పొందండి — కోడ్‌లను జనరేట్ చేయడానికి మీ సైట్ దానిని ఉపయోగిస్తుంది.

టోకెన్ ఒకసారి మాత్రమే చూపబడుతుంది: మేము దాని ఫింగర్‌ప్రింట్‌ను మాత్రమే నిల్వ చేస్తాము. అది పోతే, దాన్ని మళ్లీ జారీ చేయమని మమ్మల్ని అడగండి — పాతది పనిచేయడం ఆపేస్తుంది.

స్కీమ్ ఎలా పనిచేస్తుంది

• మీరు పేమెంట్‌ను మీ వైపే స్వీకరిస్తారు.
• పేమెంట్ తర్వాత, మీ సైట్ మా APIని కాల్ చేసి ఒక యాక్టివేషన్ కోడ్ పొందుతుంది.
• మీరు ఆ కోడ్‌ను కొనుగోలుదారుకు ఇస్తారు — ఇమెయిల్, బాట్ ద్వారా, లేదా “ధన్యవాదాలు” పేజీలో.
• కొనుగోలుదారు మా వైపు ఆ కోడ్‌ను నమోదు చేసి, పెయిడ్ ప్లాన్‌లో మోడ్‌ప్యాక్‌తో కూడిన సర్వర్‌ను పొందుతారు.
• సర్వర్‌లోని మోడ్‌ప్యాక్ ఫైల్‌లు లాక్ చేయబడి ఉంటాయి: modsను ప్యానెల్ నుండి లేదా SFTP ద్వారా డౌన్‌లోడ్ చేయలేరు.

భౌతికంగా, కొనుగోలుదారుకు సర్వర్ మోడ్‌ప్యాక్ ఎప్పుడూ చేతికి రాదు — పనిచేసే సర్వర్ మాత్రమే.

ఎండ్‌పాయింట్ మరియు ఆథరైజేషన్

బేస్ URL — https://millida.net/v2/hosting.

టోకెన్ X-Pack-Token హెడర్‌లో పంపబడుతుంది. ఇది JWT లేదా Bearer టోకెన్ కాదు — ఇది మీ మోడ్‌ప్యాక్ కోసం ఒక ప్రత్యేక సీక్రెట్.

X-Pack-Token: mpk_pack_XXXXXXXXXXXXXXXX
Content-Type: application/json

టోకెన్ మీ సర్వర్‌లో ఉంటుంది — దాన్ని ఎన్విరాన్‌మెంట్ వేరియబుల్స్‌లో ఉంచండి, ఫ్రంటెండ్ కోడ్‌లో కాదు.

కోడ్‌లను జారీ చేయండి

POST /v2/hosting/packs/{key}/keys

curl -X POST https://millida.net/v2/hosting/packs/arcania/keys \
  -H "X-Pack-Token: $PACK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"count": 1, "note": "order 4821"}'

{
  "code": "A7K2-9MHD-4RTP-QW38",
  "codes": ["A7K2-9MHD-4RTP-QW38"]
}

code ఫీల్డ్ అనేది బ్యాచ్‌లోని మొదటి కోడ్, ఇది కంపాటిబిలిటీ కోసం ఉంచబడింది; count > 1 అయినప్పుడు, codesను ఉపయోగించండి.

కోడ్‌లు ఇక్కడ మాత్రమే తిరిగి ఇవ్వబడతాయి, మరెక్కడా కాదు. మేము వాటి హాష్‌ను నిల్వ చేస్తాము — పాస్‌వర్డ్ లాగా. ఒక కోడ్ పోతే, మేము దాన్ని రికవర్ చేయలేము: కొత్తది జారీ చేసి పాతది రద్దు చేయండి.

పరిమితి ఒక మోడ్‌ప్యాక్‌కు నిమిషానికి 30 రిక్వెస్ట్‌లు. ఒక కాల్‌కు 200 కోడ్‌ల వరకు బ్యాచ్‌లు ప్రత్యేకంగా సేల్స్ కోసం ఉన్నాయి: ఒక రిక్వెస్ట్‌కు ఒక కోడ్ కాకుండా వాటిని బల్క్‌గా జనరేట్ చేయండి.

కోడ్‌లకు ఏమి జరిగింది

GET /v2/hosting/packs/{key}/keys?limit=100

[
  {
    "codeHint": "A7K29MHD",
    "note": "order 4821",
    "maxServers": 1,
    "usedCount": 1,
    "state": "spent",
    "expiresAt": null,
    "revokedAt": null,
    "createdAt": "2026-08-03T12:20:11.000Z"
  }
]

కోడ్‌లు స్వయంగా రెస్పాన్స్‌లో ఉండవు, ఉండలేవు. codeHint అనేది కోడ్ ప్రారంభం — మీ ఆర్డర్‌కు ఆ వరుసను సరిపోల్చడానికి దీన్ని ఉపయోగించండి.

స్టేట్స్: free — ఉపయోగించబడలేదు, spent — ఉపయోగించబడింది, expired — గడువు ముగిసింది, revoked — మీరు రద్దు చేసారు.

ఒకే కోడ్‌ను తనిఖీ చేయండి

POST /v2/hosting/packs/{key}/keys/status, బాడీ {"code": "A7K2-9MHD-4RTP-QW38"}.

రెస్పాన్స్ లిస్ట్‌లోని అదే వరుస. కోడ్ URLలో కాదు, బాడీలో వెళ్తుంది: URLలు ప్రాక్సీ లాగ్‌లు మరియు బ్రౌజర్ హిస్టరీలో నిలిచిపోతాయి, మరియు యాక్టివేషన్‌కు ముందు కోడ్ ఒక పనిచేసే కీ.

హైఫన్‌లు మరియు కేస్ పట్టింపు లేదు: a7k29mhd4rtpqw38 కూడా A7K2-9MHD-4RTP-QW38 లాగానే కనుగొనబడుతుంది.

కోడ్‌ను రద్దు చేయండి

POST /v2/hosting/packs/{key}/keys/revoke, బాడీ {"code": "..."}.

రీఫండ్‌లు, పొరపాటు జారీలు లేదా వివాదాల కోసం దీన్ని ఉపయోగించండి. రద్దు చేయడం భవిష్యత్ యాక్టివేషన్‌లను బ్లాక్ చేస్తుంది కానీ ఇప్పటికే డిప్లాయ్ చేయబడిన మోడ్‌ప్యాక్‌ను తొలగించదు — దాన్ని యాక్టివేట్ చేసిన కొనుగోలుదారు పనిచేసే సర్వర్‌ను కలిగి ఉంటారు.

యాక్టివేషన్ వెబ్‌హుక్

మీరు మాకు ఒక వెబ్‌హుక్ URL ఇస్తే, ఒక కోడ్ రీడీమ్ చేయబడిన క్షణంలో మేము దాన్ని కాల్ చేస్తాము:

POST <your-address>
X-Millida-Pack: arcania
Content-Type: application/json

{
  "event": "pack.activated",
  "packKey": "arcania",
  "codeHint": "A7K29MHD",
  "serverId": "cm4x...",
  "activatedAt": "2026-08-04T09:14:02.000Z"
}

ఆ కాల్ సైన్ చేయబడదు: అదే టోకెన్‌తో keys/status ద్వారా మీరు దాన్ని వెరిఫై చేయవచ్చు — codeHint ఉపయోగించి మీరు మీ వరుసను కనుగొని state: "spent" చూస్తారు. అలా మీరు రెండో సీక్రెట్‌ను నిల్వ చేయాల్సిన అవసరం ఉండదు.

వెబ్‌హుక్ రెస్పాన్స్ కోసం వేచి ఉండకుండా పంపబడుతుంది మరియు మళ్లీ ప్రయత్నించబడదు: మీ సర్వర్ డౌన్‌లో ఉన్నా, యాక్టివేషన్ అయిపోయింది, మరియు మీరు దాన్ని కోడ్ లిస్ట్‌లో చూడవచ్చు. URL పబ్లిక్‌గా ఉండాలి — మేము ఇంటర్నల్ లేదా లోకల్ అడ్రస్‌లను కాల్ చేయము. రీడైరెక్ట్‌లు ఫాలో చేయబడవు.

మోడ్‌ప్యాక్ కార్డు

GET /v2/hosting/packs/{key} పబ్లిక్, టోకెన్ అవసరం లేదు. కొనుగోలుదారు చూసేది ఇది తిరిగి ఇస్తుంది: పేరు, కోర్, వెర్షన్, కనీస మెమరీ, ప్లాన్ లిస్ట్ మరియు ప్రొటెక్షన్ ఫ్లాగ్‌లు. రెస్పాన్స్‌లో ఆర్కైవ్ లింక్ ఉండదు.

మీ సైట్‌లోని “కొనండి” పేజీకి ఇది ఉపయోగకరం: ప్లాన్ అవసరాలు ఒకే మూలం నుండి వస్తాయి మరియు మా విజార్డ్ చెప్పే దానితో విభేదించవు.

మీ కార్డు యొక్క స్టోర్‌ఫ్రంట్ ఫీల్డ్‌లను మీరే ఎడిట్ చేస్తారు: టోకెన్‌తో PATCH /v2/hosting/packs/{key} అనేది name, authorName, authorUrl, iconUrl, webhookUrlను అంగీకరిస్తుంది. సేల్ నిబంధనలు (paidOnly, requireKey, lockFiles, planCodes), స్టోర్‌ఫ్రంట్‌లో మోడ్‌ప్యాక్‌ను ఎనేబుల్ చేయడం మరియు JVM లాంచ్ ఫ్లాగ్‌లు టోకెన్‌తో మార్చలేరు — అవి మీతో మా ఒప్పందం మరియు మా నోడ్‌లు, కాబట్టి వాటి గురించి మాకు రాయండి.

మోడ్‌ప్యాక్ అప్‌డేట్‌లు

మునుపు అప్‌డేట్ అంటే మాకు ఇమెయిల్ పంపి వేచి ఉండటం. ఇప్పుడు మీరు ఒక వెర్షన్‌ను మీరే పబ్లిష్ చేస్తారు, మరియు సర్వర్ యజమానులు తమ ప్యానెల్‌లో దాన్ని ఎంచుకుంటారు.

ముఖ్యమైన విషయం: మేము ఎవరికీ నిశ్శబ్దంగా అప్‌డేట్ చేయము. మోడ్‌ప్యాక్ వెర్షన్‌ల మధ్య మారడం వరల్డ్‌తో ఇన్‌కంపాటిబుల్ కావచ్చు, మరియు నిర్ణయం సర్వర్ యజమానిదే. పబ్లిష్ చేసిన వెర్షన్ కొత్త సర్వర్‌లకు లభిస్తుంది మరియు ఇప్పటికే డిప్లాయ్ చేయబడిన వాటికి మేము సూచించేది అదే; మునుపటి వెర్షన్‌లు లిస్ట్‌లో ఉంటాయి, మరియు మీరు వాటిపై ఉండవచ్చు లేదా రోల్‌బ్యాక్ చేయవచ్చు.

సైకిల్ ఎలా ఉంటుంది

# 1. Create a version
curl -X POST https://millida.net/v2/hosting/packs/arcania/versions \
  -H "X-Pack-Token: $PACK_TOKEN" -H "Content-Type: application/json" \
  -d '{"label":"1.5.0","changelog":"Updated Create to 0.5.1, fixes crash on portals","minRamMb":10240}'

# 2. Upload the archive in chunks (32 MB each), addressing by offset
curl -X POST "https://millida.net/v2/hosting/packs/arcania/versions/1.5.0/archive?offset=0" \
  -H "X-Pack-Token: $PACK_TOKEN" -H "Content-Type: application/octet-stream" \
  --data-binary @part0.bin

# 3. Say the archive is finished, and publish after parsing
curl -X POST https://millida.net/v2/hosting/packs/arcania/versions/1.5.0/finish \
  -H "X-Pack-Token: $PACK_TOKEN" -H "Content-Type: application/json" \
  -d '{"archiveSha256":"<sha256 of archive>","publish":true}'

# 4. Wait for parsing
curl https://millida.net/v2/hosting/packs/arcania/versions/1.5.0 -H "X-Pack-Token: $PACK_TOKEN"

వెర్షన్

అప్‌లోడ్

POST /v2/hosting/packs/{key}/versions/{label}/archive?offset=N, బాడీ — .zip యొక్క ఒక భాగం, Content-Type: application/octet-stream. భాగం 32 MB వరకు, మొత్తం ఆర్కైవ్ 4 GB వరకు.

ఒక భాగాన్ని ఆఫ్‌సెట్‌తో, “చివరికి జోడించు” అనే పద్ధతిలో కాదు చేరుస్తారు: మధ్యలో ఆగిన భాగం ఇప్పటికే ఫైల్‌లో పాక్షికంగా చేరి ఉంటుంది, మళ్లీ ప్రయత్నిస్తే అదే బైట్లు రెండోసారి జోడించబడతాయి — ఆర్కైవ్ మౌనంగా పాడైపోతుంది. ప్రతిస్పందన uploadedBytes ఇస్తుంది, దాన్ని ఉపయోగించి అంతరాయం తర్వాత అప్‌లోడ్‌ను కొనసాగించవచ్చు.

పార్సింగ్

POST .../finish వెంటనే ప్రతిస్పందిస్తుంది (status: "processing"), పార్సింగ్ మాత్రం నేపథ్యంలో నడుస్తుంది: గిగాబైట్ సైజు సర్వర్ సెటప్‌ను విప్పడానికి నిమిషాలు పడతాయి. స్థితిని GET .../versions/{label} నుండి చదవండి: processing → ready లేదా failed, కారణం error లో ఉంటుంది.

ఆర్కైవ్ తప్పనిసరిగా ఈ పరీక్షలు దాటాలి:

• ఇది సర్వర్ ప్యాక్ అయి ఉండాలి: ఒకే ర్యాపర్ (Server Files/ వంటివి) తీసేసిన తర్వాత, రూట్‌లో mods/ లేదా plugins/ ఉండాలి. సర్వర్‌పై క్లయింట్ ప్యాక్ ఖాళీ ప్రపంచాన్ని ఇస్తుంది, కాబట్టి ఇన్‌స్టాల్ చేయకుండా మేము తిరస్కరిస్తాము;
• ఆర్కైవ్ లోపల పేర్లలో .., అబ్సొల్యూట్ పాత్‌లు, లేదా Windows సెపరేటర్లు ఉండకూడదు;
• పాస్‌వర్డ్ ఉండకూడదు, అసాధారణ కంప్రెషన్ పద్ధతులు ఉండకూడదు (store మరియు deflate మాత్రమే);
• పరిమితులు: 60,000 ఫైల్స్, విప్పిన తర్వాత 12 GB, కంప్రెషన్ నిష్పత్తి 200× వరకు.

ఒక వైఫల్యం ప్రచురించిన వెర్షన్‌ను ప్రభావితం చేయదు: మీ క్లయింట్లు మునుపటి దాన్నే నడుపుతూనే ఉంటాయి, మీరు మళ్లీ అప్‌లోడ్ చేయవచ్చు. పూర్తికాని డ్రాఫ్ట్‌లు: ఒక సర్వర్ సెటప్‌కు మూడు కంటే ఎక్కువ ఉండకూడదు, వదిలేసినవి ఒక రోజు తర్వాత స్వయంచాలకంగా శుభ్రం చేయబడతాయి.

ప్రచురణ, రోల్‌బ్యాక్, మరియు తొలగింపు

ప్రచురణ కోర్, గేమ్ వెర్షన్, లోడర్ పిన్, Java, మరియు వెర్షన్ యొక్క మెమరీ కనీస పరిమితిని సర్వర్ సెటప్ కార్డ్‌లోకి బదిలీ చేస్తుంది: మీ వైపు ఎలాంటి అదనపు చర్య లేకుండానే కొత్త సర్వర్లకు అది లభిస్తుంది.

సర్వర్ యజమానికి ఏమి కనిపిస్తుంది

ప్యానెల్‌లో, ప్రీమియం సర్వర్ సెటప్ బ్లాక్‌లో: ఏ వెర్షన్ ఇన్‌స్టాల్ అయింది, ఏది విడుదలైంది, మీ changelog, మరియు “Switch” బటన్‌తో వెర్షన్ల జాబితా. అప్‌డేట్ ప్రపంచాన్ని ప్రభావితం చేయదు — సర్వర్ సెటప్ ఫైల్స్ మాత్రమే భర్తీ అవుతాయి, భర్తీ చేయడానికి ముందు మేము ఒక కాపీ తీసుకుంటాము. మీరు అనుమతించిన కస్టమ్ మోడ్‌లు ఉంటే, మారిన తర్వాత వాటిని మళ్లీ జోడించాల్సి ఉంటుంది: సర్వర్ సెటప్ ఒకే మొత్తంగా కదులుతుంది, mods/ లో పాత వెర్షన్ సగం మిగిలితే స్టార్టప్‌లో క్రాష్ అవుతుంది.

యజమాని ప్లాన్ ఒక వెర్షన్‌ను భరించలేకపోతే, దాన్ని దాచకుండా కారణంతో సహా చూపిస్తాము: సర్వర్ సెటప్ ఎందుకు అప్‌డేట్ అవ్వడం లేదో ఊహించకుండా, ఏమి అవసరమో ఆ వ్యక్తి చూడాలి.

మీ స్వంత సర్వర్ సెటప్ పేజీ

మీ సర్వర్ సెటప్ కోసం ల్యాండింగ్ పేజీని మీరే మీ ఖాతాలో నిర్మించుకుంటారు (ప్రొఫైల్ → “My server setups” → “Server setup pages”): మొదటి స్క్రీన్, ఫీచర్లు, స్క్రీన్‌షాట్‌లు, ప్రశ్న-జవాబులు, మీ రంగులు. ప్లాన్లు మరియు వెర్షన్ జాబితా మా డేటాతో నిండుతాయి, కాబట్టి అవి పాతబడవు.

పూర్తయిన పేజీ millida.net/sborka/<your-address> లో ఉంటుంది — ఇది సాధారణ వెబ్‌సైట్ పేజీ, సెర్చ్ ఇంజిన్లు ఇండెక్స్ చేస్తాయి, మా సైట్‌మ్యాప్‌లో చేర్చబడుతుంది. డ్రాఫ్ట్ మీకు తప్ప ఎవరికీ కనిపించదు.

చిత్రాలు అదే చోట, మీ ఖాతాలో అప్‌లోడ్ చేస్తారు: పేజీ మా డొమైన్ నుండి అందించబడుతుంది, దాని ఫైల్స్ మా దగ్గర నిల్వ ఉంటాయి — మీ హోస్టింగ్ పడిపోయినా పేజీ చెక్కుచెదరకుండా ఉంటుంది.

పేజీలను API ద్వారా సవరించలేరు: ఇది ఒక స్క్రీన్, రోలౌట్ కాదు.

ప్రతిస్పందన కోడ్‌లు

అమ్మకానికి ముందు అంతా ఎలా పరీక్షించాలి

మమ్మల్ని రెండు టెస్ట్ కోడ్‌లు అడగండి: API ద్వారా ఒక కోడ్ ఇష్యూ చేయండి, మా హోస్టింగ్‌లో మీ సర్వర్‌పై దాన్ని యాక్టివేట్ చేయండి, వెబ్‌హుక్‌లో ఏమి వచ్చిందో మరియు keys/status ఏమి చూపుతుందో చూడండి. అలా మొదటి పేయింగ్ కస్టమర్ ఆ మార్గం గుండా వెళ్లే ముందే కొనుగోలుదారు మొత్తం ప్రయాణాన్ని మీరు చూస్తారు.