anno117-mod-manager/API_KEY_GUIDE.html at main · Wik3ndi/anno117-mod-manager · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>How to Get Your mod.io API Key</title>
    <style>
        body {
            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
            max-width: 800px;
            margin: 0 auto;
            padding: 20px;
            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
            color: #333;
        }
        .container {
            background: white;
            border-radius: 15px;
            padding: 40px;
            box-shadow: 0 10px 40px rgba(0,0,0,0.2);
        }
        h1 {
            color: #667eea;
            text-align: center;
            margin-bottom: 10px;
        }
        .subtitle {
            text-align: center;
            color: #666;
            margin-bottom: 40px;
            font-size: 18px;
        }
        .step {
            background: #f8f9fa;
            border-left: 4px solid #667eea;
            padding: 20px;
            margin: 25px 0;
            border-radius: 5px;
            position: relative;
        }
        .step-number {
            position: absolute;
            top: -15px;
            left: -15px;
            background: #667eea;
            color: white;
            width: 35px;
            height: 35px;
            border-radius: 50%;
            display: flex;
            align-items: center;
            justify-content: center;
            font-weight: bold;
            font-size: 18px;
            box-shadow: 0 3px 10px rgba(102, 126, 234, 0.3);
        }
        .step h3 {
            margin-top: 0;
            color: #667eea;
            font-size: 20px;
        }
        .step p {
            margin: 10px 0;
            line-height: 1.6;
        }
        .highlight {
            background: #fff3cd;
            padding: 2px 8px;
            border-radius: 3px;
            font-weight: 600;
            color: #856404;
        }
        .link-button {
            display: inline-block;
            background: #667eea;
            color: white;
            padding: 12px 30px;
            border-radius: 25px;
            text-decoration: none;
            font-weight: bold;
            transition: all 0.3s;
            box-shadow: 0 4px 15px rgba(102, 126, 234, 0.4);
        }
        .link-button:hover {
            background: #5568d3;
            transform: translateY(-2px);
            box-shadow: 0 6px 20px rgba(102, 126, 234, 0.5);
        }
        .warning {
            background: #fff3cd;
            border-left: 4px solid #ffc107;
            padding: 15px;
            margin: 20px 0;
            border-radius: 5px;
        }
        .warning strong {
            color: #856404;
        }
        .success {
            background: #d4edda;
            border-left: 4px solid #28a745;
            padding: 15px;
            margin: 20px 0;
            border-radius: 5px;
        }
        .success strong {
            color: #155724;
        }
        .center {
            text-align: center;
            margin: 30px 0;
        }
        code {
            background: #f4f4f4;
            padding: 3px 8px;
            border-radius: 3px;
            font-family: 'Courier New', monospace;
            color: #e83e8c;
        }
        .path {
            font-family: 'Courier New', monospace;
            background: #f4f4f4;
            padding: 10px;
            border-radius: 5px;
            margin: 10px 0;
            font-size: 14px;
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>🎮 Get Your mod.io API Key</h1>
        <p class="subtitle">Follow these simple steps to enable the Anno 117 Mod Manager</p>

        <div class="center">
            <a href="https://mod.io" target="_blank" class="link-button">Go to mod.io →</a>
        </div>

        <div class="step">
            <div class="step-number">1</div>
            <h3>Create a mod.io Account</h3>
            <p>Visit <strong>mod.io</strong> and click the <span class="highlight">Sign In</span> button in the top right corner.</p>
            <p>You can sign in using:</p>
            <ul>
                <li>🎮 Steam account (recommended)</li>
                <li>🔵 Google account</li>
                <li>📧 Email address</li>
            </ul>
        </div>

        <div class="step">
            <div class="step-number">2</div>
            <h3>Access API Settings</h3>
            <p>Once logged in, click on your <span class="highlight">profile picture</span> in the top right corner.</p>
            <p>From the dropdown menu, select <span class="highlight">API Access</span>.</p>
        </div>

        <div class="step">
            <div class="step-number">3</div>
            <h3>Find Your API Key</h3>
            <p>On the API Access page, look for the section titled <span class="highlight">API Key</span> (not OAuth Access).</p>
            <p>You should see a 32-character API key already generated for you.</p>
            <p>Click the <span class="highlight">copy button</span> next to it.</p>
        </div>

        <div class="warning">
            <strong>⚠️ Important:</strong> Keep your API key private! Don't share it publicly or post it online.
        </div>

        <div class="step">
            <div class="step-number">4</div>
            <h3>Paste into Mod Manager</h3>
            <p>When you first run the Anno 117 Mod Manager, a dialog will appear asking for your API key.</p>
            <p>Simply paste your key and check <span class="highlight">"Remember my API key"</span> to save it for future use.</p>
        </div>

        <div class="success">
            <strong>✅ That's it!</strong> Your API key will be saved in:<br>
            <div class="path">C:\Users\YourUsername\.anno117_mod_manager_config.json</div>
            <p style="margin-top: 10px;">You won't need to enter it again unless you delete this file.</p>
            <p style="margin-top: 10px;"><strong>Mods will be installed to:</strong><br>
            <div class="path">C:\Users\YourUsername\Documents\Anno 117 - Pax Romana\mods\</div></p>
        </div>

        <hr style="margin: 40px 0; border: none; border-top: 2px solid #eee;">

        <h2 style="color: #667eea;">Troubleshooting</h2>

        <div class="step">
            <h3>❓ "API Key Required" Error</h3>
            <p>If you see this error, it means the mod manager couldn't find your API key. Make sure you:</p>
            <ul>
                <li>Created a token on mod.io</li>
                <li>Copied the entire token (they're quite long!)</li>
                <li>Pasted it correctly when the mod manager asked</li>
            </ul>
        </div>

        <div class="step">
            <h3>❓ "404 Client Error" Message</h3>
            <p>This usually means:</p>
            <ul>
                <li>Your API key is invalid or expired</li>
                <li>You need to create a new token on mod.io</li>
                <li>Check that you selected "Read-only" access</li>
            </ul>
        </div>

        <div class="step">
            <h3>❓ Want to Reset Your API Key?</h3>
            <p>Delete the config file located at:</p>
            <div class="path">C:\Users\YourUsername\.anno117_mod_manager_config.json</div>
            <p>The mod manager will ask for your API key again next time you run it.</p>
        </div>

        <div class="center" style="margin-top: 50px;">
            <p style="color: #666;">Happy modding! 🎮</p>
        </div>
    </div>
</body>
</html>