Skip to content

Commit f54d6e7

Browse files
stiangrestiangre
committed
Website: Updates the download instructions with answers on how to solve common problems.
1 parent 0832ea7 commit f54d6e7

File tree

2 files changed

+65
-42
lines changed

2 files changed

+65
-42
lines changed

‎www.freecol.org/download.html

+63-41
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
freecol-1.2.0-with-java.exe
2222
</a>
2323
</td>
24-
<td class="cBody">Windows Installer</td>
24+
<td class="cBody">Windows Installer with Java included</td>
2525
</tr>
2626
<tr class="cBody">
2727
<td class="cBody">
@@ -31,10 +31,10 @@
3131
</td>
3232
<td class="cBody" width="200">
3333
<a href="https://sourceforge.net/projects/freecol/files/freecol/freecol-1.2.0/FreeCol-1.2.0.dmg/download">
34-
freecol-1.2.0.dmg
34+
freecol-1.2.0.dmg <a href="#howto-macos">⚠️</a>
3535
</a>
3636
</td>
37-
<td class="cBody">Package for macOs M1/M2</td>
37+
<td class="cBody">Package for macOs M1/M2 with Java included</td>
3838
</tr>
3939
<tr class="cBody">
4040
<td class="cBody">
@@ -44,10 +44,10 @@
4444
</td>
4545
<td class="cBody" width="200">
4646
<a href="https://sourceforge.net/projects/freecol/files/freecol/freecol-1.2.0/FreeCol-intel-1.2.0.dmg/download">
47-
freecol-intel-1.2.0.dmg
47+
freecol-intel-1.2.0.dmg <a href="#howto-macos">⚠️</a>
4848
</a>
4949
</td>
50-
<td class="cBody">Package for macOs Intel</td>
50+
<td class="cBody">Package for macOs Intel with Java included</td>
5151
</tr>
5252
<tr class="cBody">
5353
<td class="cBody">
@@ -90,64 +90,85 @@
9090
</tr>
9191
</tbody>
9292
</table>
93-
<h4>Requirements:</h4>
94-
All platforms:
95-
<br />
93+
<h4>Minimum System Requirements:</h4>
94+
<ul>
95+
<li>A minimum screen resolution of 800x600
96+
<li>2 GB RAM <span style="color: #aaaaaa;">(512MB for FreeCol)</span></li>
97+
<li>0,5 GB disk space</li>
98+
<li>When choosing a package without bundled java:<br />Java Virtual Machine version 11 or above</li>
99+
</ul>
100+
<h4>Recommended System Requirements:</h4>
96101
<ul>
97-
<li><strong>Java Virtual Machine version 11 or above</strong></li>
98-
<li>A minimum screen resolution of 1024x768 (Full HD 1080p recommended, especially for the map editor)</li>
102+
<li>4K resolution on a high-DPI screen</li>
103+
<li>16GB RAM <span style="color: #aaaaaa;">(4GB for FreeCol)</span></li>
104+
<li>2 GB VRAM</li>
105+
<li>A CPU with at least 4 cores</li>
106+
<li>0,5 GB disk space</li>
107+
<li>When choosing a package without bundled java:<br />Java Virtual Machine version 21 or above</li>
99108
</ul>
100-
<h4>Instructions:</h4>
109+
110+
<br />
111+
<h3><a name="howto-windows">Instructions for Windows:</a></h3>
101112
<p align="justify">
102113
Windows users should download
103114
<a href="https://sourceforge.net/projects/freecol/files/freecol/freecol-1.2.0/freecol-1.2.0-with-java.exe/download">freecol-1.2.0-with-java.exe</a>.
104115
You can run the file directly or save it to disk. If you choose the latter then just double-click the file once it&#39;s downloaded.
105-
<br /><br />
116+
</p>
117+
<p align="justify">
118+
There are two shortcuts generated by the installer: "FreeCol" and "FreeCol (2GB)". The former uses 25% of the available RAM on the system while the latter always uses 2GB. Use "FreeCol (2GB)" if you have less than 8GB RAM.
119+
</p>
120+
121+
<br />
122+
<h3><a name="howto-macos">Instructions for macOs:</a></h3>
123+
<p align="justify">
106124
macOs users should download either
107125
<a href="https://sourceforge.net/projects/freecol/files/freecol/freecol-1.2.0/FreeCol-1.2.0.dmg/download">freecol-1.2.0.dmg</a> (M1/M2)
108126
or <a href="https://sourceforge.net/projects/freecol/files/freecol/freecol-1.2.0/FreeCol-intel-1.2.0.dmg/download">freecol-intel-1.2.0.dmg</a> (Intel). The latter is for older macs.
109-
FreeCol has some problems running on macOs, so you should save your game frequently. You might also need to get the file out of quarantine after downloading it since we have not signed the application for the M1/M2 package:
127+
FreeCol has some problems running on macOs, so you should keep the autosave feature on.
128+
</p>
129+
<p align="justify">
130+
There are issues when having the screen use a non-native resolution. If possible, please do try changing the resolution of the screen to native before running FreeCol.
131+
</p>
132+
<p align="justify">
133+
You might also need to get the file out of quarantine after downloading it since we have not signed the application. Commands for the M1/M2 package:
110134
<br />
111-
<div style="font-family: monospace">
135+
<div style="font-family: monospace; border: 1px solid #888888; padding: 0.5rem 0.5rem 0.5rem 0.5rem; background-color: #000000; color: #ffffff;">
112136
xattr -d com.apple.quarantine FreeCol-1.2.0.dmg
113137
<br />xattr -d com.apple.quarantine FreeCol.app
114138
</div>
115139
<br />
116140
...and for the Intel package:
117141
<br /><br />
118-
<div style="font-family: monospace">
142+
<div style="font-family: monospace; border: 1px solid #888888; padding: 0.5rem 0.5rem 0.5rem 0.5rem; background-color: #000000; color: #ffffff;">
119143
xattr -d com.apple.quarantine FreeCol-intel-1.2.0.dmg
120144
<br />xattr -d com.apple.quarantine FreeCol.app
121145
</div>
122-
<br />
146+
</p>
147+
148+
<br />
149+
<h3><a name="howto-other">Instructions for Linux/other:</a></h3>
150+
<p align="justify">
151+
FreeCol is included as a package in several BSD and Linux distributions, so you could try installing FreeCol in the normal manner for your system (package manager).
152+
<p align="justify">
153+
</p>
154+
<p align="justify">
155+
You need to install Java (minimum 11, preferably 21) in order to run FreeCol. You should use the latest Java that is available through the package manager on your system. Alternatively, you could <a href="https://adoptium.net/temurin/releases/?os=linux&arch=x64&package=jdk&version=21">download Java</a> and manually install it.
156+
</p>
157+
<p align="justify">
123158
Users that know how to start a java program can download <a href="https://sourceforge.net/projects/freecol/files/freecol/freecol-1.2.0/freecol-1.2.0-installer.jar/download">freecol-1.2.0-installer.jar</a>. Start the installation program by running the command: &quot;java -jar freecol-1.2.0-installer.jar&quot;. This installer is recommended for Linux users. <br /><br />
124159
If you don&#39;t need a desktop icon and you know how to start a java program then you can download <a href="https://sourceforge.net/projects/freecol/files/freecol/freecol-1.2.0/freecol-1.2.0.zip/download">freecol-1.2.0.zip</a>.
125160
</p>
126-
<h4>Help, Feedback &amp; Bugs:</h4>
127-
<p align="justify">Help requests and feedback can be sent via e-mail to
128-
<script language='JavaScript' type='text/javascript'>
129-
<!--
130-
var prefix = '&#109;a' + 'i&#108;' + '&#116;o';
131-
var path = 'hr' + 'ef' + '=';
132-
var addy68108 = 'fr&#101;&#101;c&#111;l-&#117;s&#101;rs' + '&#64;';
133-
addy68108 = addy68108 + 'l&#105;sts' + '&#46;' + 's&#111;&#117;rc&#101;f&#111;rg&#101;' + '&#46;' + 'n&#101;t';
134-
var addy_text68108 = 'the mailing list';
135-
document.write( '<a ' + path + '\'' + prefix + ':' + addy68108 + '\'>' );
136-
document.write( addy_text68108 );
137-
document.write( '<\/a>.' );
138-
document.write( '<span style=\'display: none;\'>' );
139-
//-->
140-
</script>
141-
This e-mail address is being protected from spam bots, you need JavaScript enabled to view it.
142-
<script language='JavaScript' type='text/javascript'>
143-
<!--
144-
document.write( '</' );
145-
document.write( 'span>' );
146-
//-->
147-
</script>
148-
Please submit bugs through the SourceForge <a href="https://sourceforge.net/p/freecol/bugs/">bug tracker</a> and request new features by using the <a href="https://sourceforge.net/p/freecol/improvement-requests/">feature request tracker</a>.</p>
149-
150-
<h4>The latest development version of FreeCol:</h4>
161+
162+
<br />
163+
<h3>Help, Feedback &amp; Bugs:</h3>
164+
<p align="justify">
165+
Help requests and feedback can be posted on one of our <a href="https://sourceforge.net/p/freecol/discussion/">forums</a> or by using the <a href="https://discord.gg/wVvGKugNFy">FreeCol channel on this Discord server</a>.
166+
</p>
167+
<p align="justify">
168+
Please submit bugs through the SourceForge <a href="https://sourceforge.net/p/freecol/bugs/">bug tracker</a> and request new features by using the <a href="https://sourceforge.net/p/freecol/improvement-requests/">feature request tracker</a>. Please also check out our <a href="/roadmap.html">roadmap</a>.
169+
</p>
170+
<br />
171+
<h3>The Latest Development Version of FreeCol:</h3>
151172
You can download the <a href="https://github.com/FreeCol/freecol/releases/tag/latest">latest development build</a> if you would like to test the game or try changes
152173
before they are included in an official version. The development build includes platform independent installers and source files, but you will manually have to install
153174
Java. If you want to contribute you can:
@@ -157,3 +178,4 @@ <h4>The latest development version of FreeCol:</h4>
157178
<li>Discuss FreeCol releases on our <a href="https://sourceforge.net/p/freecol/discussion/">Forums</a>.</li>
158179
<li>Contribute to our <a href="https://sourceforge.net/p/freecol/git/">code base</a> by Forking and submitting a Pull Request.</li>
159180
</ul>
181+
<br />

‎www.freecol.org/status.html

+2-1
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,5 @@
66
path: /about.html
77
name: About FreeCol
88
---
9-
<p>FreeCol is continuously developed. For more on the latest Freecol development progress, please visit the <a href="https://sourceforge.net/projects/freecol/" title="FreeCol on SourceForge">SourceForge Project page</a> or our <a href="https://github.com/FreeCol/freecol/" title="FreeCol on GitHub">GitHub Mirror (including Nightly Releases)</a>.</p>
9+
<p>FreeCol is continuously developed. For more on the latest Freecol development progress, please visit the <a href="/roadmap.html">roadmap</a>, <a href="https://sourceforge.net/projects/freecol/" title="FreeCol on SourceForge">SourceForge Project page</a> or our <a href="https://github.com/FreeCol/freecol/" title="FreeCol on GitHub">GitHub Mirror (including Nightly Releases)</a>.</p>
10+
<p>There are often development related discussions on the <a href="https://discord.gg/wVvGKugNFy">FreeCol channel on this Discord server</a>.

0 commit comments

Comments
 (0)