use HTTPS for remote auth
[yukkurigames.com.git] / support.html
1 <!DOCTYPE html>
2 <html>
3 <head>
4 <meta charset="utf-8">
5 <meta name=viewport content="width=device-width, initial-scale=1">
6 <link rel="stylesheet" href="/css/main.css" type="text/css">
7 <link rel=apple-touch-icon sizes=256x256 href=favicon_256.png>
8 <link rel=icon sizes="16x16 32x32 48x48" href=favicon.ico>
9 <link rel=icon sizes=128x128 href=favicon_128.png>
10 <link rel=icon sizes=192x192 href=favicon_192.png>
11 <link rel=icon sizes=256x256 href=favicon_256.png>
12 <title>Support ~ Yukkuri Games</title>
13 <style>
14 img[alt=Share] {
15 height: 1em;
16 vertical-align: text-bottom;
17 width: auto;
18 }
19 </style>
20 </head>
21 <body>
22 <header>
23 <a href="/">
24 <img src="/logotype_horizontal_1.png" class=logo alt="(◕ ヮ ◕)">
25 <img src="/logotype_horizontal_2.png" class=optional
26 alt="Yukkuri Games">
27 </a>
28 <h1>Support</h1>
29 </header>
30 <main>
31 <h2>Common Issues</h2>
32 <p>
33 If your problem isn't covered by the suggestions below, please
34 <a href="mailto:yuuSPAM@MAPSyukkurigames.com"
35 onclick="this.href=this.href.replace(/[A-Z]/g, '')"
36 >email us</a>. Include as much
37 information as you can about your computer's operating system
38 and hardware, especially its GPU.
39 </p>
40 <h3>"WebGL isn't supported" on Windows</h3>
41 <ul>
42 <li>
43 Install the
44 <a href="http://www.microsoft.com/en-us/download/details.aspx?id=35">DirectX End-User Runtime</a>
45 from Microsoft.
46 </li>
47 <li>
48 Check if <a href="http://get.webgl.org/">your regular
49 browser supports WebGL</a>. If it doesn't, try following the
50 instructions there to enable it.
51 </li>
52 </ul>
53 <h3>"WebGL isn't supported" on GNU/Linux</h3>
54 <ul>
55 <li>
56 Check if <a href="http://get.webgl.org/">your regular browser
57 supports WebGL</a>. If it doesn't, try following the
58 instructions there to enable it.
59 </li>
60 <li>
61 Most GNU/Linux distributions offer two (or more) drivers for
62 popular video cards, a free one and a proprietary one. Try
63 switching to the other one. Unfortunately, this process is
64 different between different distributions and different
65 graphics cards, so we can't describe it here. Try
66 <a href="https://help.ubuntu.com/community/VideoDriverHowto">the official documentation for video drivers on Ubuntu</a>,
67 <a href="https://wiki.ubuntu.com/Valve">Valve's guide to video drivers on Ubuntu</a>,
68 or <a href="http://rpmfusion.org/Howto/nVidia">RPMFusion's guide to NVIDIA drivers on Fedora</a>.
69 </li>
70 </ul>
71 <h3 id=gatekeeper>
72 Gatekeeper / "can't be opened because it is
73 from an unidentified developer" on Mac OS X
74 </h3>
75 <p>
76 Open <strong>System Preferences</strong>,
77 pick <strong>Security &amp; Privacy</strong> and select
78 the
79 <strong>General</strong> tab. Change the "Allow applications
80 downloaded from" selection to <strong>Anywhere</strong>.
81 (You might need to click on the lock icon and enter your
82 password first.)
83 </p>
84 <p>
85 If you're nervous about enabling programs from anywhere and
86 only want to run this one program, you can right-click (/
87 two-finger tap / control-click) on the application and choose
88 <strong>Open</strong>.
89 </p>
90 <p>
91 However, we really recommend disabling Gatekeeper entirely.
92 Even set to <strong>Anywhere</strong> you'll still get a
93 warning when you first run unidentified programs. Repeated
94 mistakes on Apple's part have ruined whatever security it
95 might have offered, and because they've mixed the security
96 features up with their commercial interests in the App Store,
97 they're unlikely to fix the problem.
98 </p>
99 <h3>Unable to load file://...</h3>
100 <p>
101 You've probably cloned one of our Git repositories or unpacked
102 a <code>.nw</code> file yourself and tried to open the game's files
103 directly in your browser. Unfortunately, browsers disable most
104 access to local files for security reasons, so you can't
105 run things like this.
106 </p>
107 <p>
108 If you're running files exactly from a <code>.nw</code> file, you
109 can replace that file with a directory of the same name, and
110 the included
111 <a href="https://github.com/rogerwang/node-webkit">node-webkit</a>
112 shell will use the files in the directory.
113 </p>
114 <p>
115 If you're not using node-webkit, you'll need to run a local
116 HTTP server. Some of our projects will do this automatically
117 if you run <code>make serve</code>; otherwise you can probab
118 y run <code>python -m SimpleHTTPServer</code> and then open
119 <code>http://localhost:8000</code> in your browser.
120 </p>
121
122 <h3>"Firefox is currently in offline mode and can't browse the Web."</h3>
123 <p>
124 This is a <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1067593">bug
125 in Firefox when loading appcaches over HTTPS</a>. To work around it, you
126 can go to <strong>Preferences → Advanced → Network → Offline
127 Web Content and User Data</strong>, find "yukkurigames.com" in
128 the list, and remove it. Then it will work again, at least
129 until your next Firefox upgrade.
130 </p>
131 <p>
132 Appcaches are what lets you access parts of our site even when
133 you're offline; HTTPS is what makes sure when you are online
134 you're getting the updates to those apps from our site and not
135 someone trying to send you a virus. We could disable appcaches
136 but then no one would be able to use the site at all offline
137 (and this bug only affects Firefox).
138 </p>
139
140 <h2 id=mobile>Mobile Browsers</h2>
141 <p>
142 If we labeled something "(Mobile) Browser" this means you can
143 use it as a standalone app on your phone or tablet. It will
144 work even when you're not connected to the Internet, and the
145 will change to better fit a browser-less UI.
146 </p>
147 <p>
148 We try to support iOS 6+, and Android Chrome (which means
149 Android 4.0+). The sites will still work fine in most other
150 mobile browsers, but you won't be able to save them easily for
151 offline use. On iOS 6, use the <img src=share-ios6.png alt=Share> button.
152 On iOS 7+, use the <img src=share-ios7.png alt=Share> button.
153 On Android Chrome, use the <img src=share-android.png alt=Share> button.
154 Then choose <strong>Add to Home Screen</strong>.
155 </p>
156 <p>
157 The app will auto-upgrade when you run it while connected to
158 the Internet. Though, this upgrade process often fails because
159 of poor browser support for offline mode - if something goes
160 wrong, you can just delete the application and add it again.
161 Sorry about that.
162 </p>
163
164 <h2>Licenses</h2>
165 <p>
166 As much as possible we've placed stuff under <a href="http://www.gnu.org/philosophy/free-sw.html#content">free software</a> or <a href="http://creativecommons.org/freeworks">free culture</a> licenses.
167 That means you can do pretty much whatever you want with
168 anything you find on our site, as long as you ensure other
169 people can do the same thing with what you make.
170 </p>
171 <p>
172 Most software we've licensed under the
173 <a href="http://www.gnu.org/copyleft/gpl.html">GNU General
174 Public License</a>, though some parts may be under more
175 liberal licenses.
176 </p>
177 <p>
178 We also make play aids, expansions, and variants for other
179 people's games The original games aren't always free, and we
180 don't want to lay any claim (exclusive or otherwise) to them.
181 So this work is usually released into the public domain.
182 </p>
183 <p>
184 If you believe we've violated your licensing terms or
185 otherwise misattributed some of your work, please
186 <a href="mailto:yuuSPAM@MAPSyukkurigames.com"
187 onclick="this.href=this.href.replace(/[A-Z]/g, '')">let us know via email</a>.
188 </p>
189 <h2>Other Problems?</h2>
190 <p>
191 If you have other problems or questions about our site, our
192 software, or using our source code,
193 <a href="mailto:yuuSPAM@MAPSyukkurigames.com"
194 onclick="this.href=this.href.replace(/[A-Z]/g, '')"
195 >email us</a>.
196 </p>
197 </main>
198 </body>
199 </html>