项目作者: Bios-Marcel

项目描述 :
SA-MP Server Browser including some extra functions
高级语言: Kotlin
项目地址: git://github.com/Bios-Marcel/ServerBrowser.git
创建时间: 2017-02-03T16:19:51Z
项目社区:https://github.com/Bios-Marcel/ServerBrowser

开源协议:Mozilla Public License 2.0

下载


SA-MP Server Browser

Codacy grade
Waffle.io - Columns and their card count

master: Build Status

develop: Build Status

Description

This application offers a row of tools for the San Andreas-Multiplayer mod for the Grand Theft Auto: San Andreas game.

Features

  • Save your favourite servers
  • Access to a list of currently over 2000 servers
  • Version changer
  • Username history
  • Access to SA-MP Settings via graphical user interface
  • Access to SA-MP chat logs (with colors and timestamps)
  • Server history
  • MORE TO COME …
    • Server-specific usernames
    • Screenshot viewer

Donate

If you want to make me feel better, since i am dedicating my free time to do this, feel free to donate something on https://ko-fi.com/marcelschr .

Languages

This software is currently available in the following languages (some might not be perfectly and completly translated):

  • English
  • German
  • Georgian (Translated by Medzvel)
  • Greek (Translated by vassilis)
  • Dutch (Translated by Jsytlez)
  • Russian (Translated by Codeah)
  • Polish (Translated by AbyssMorgan)
  • Romanian (Translated by IstuntmanI)
  • Spanish (Translated by Unrea1, updated by RIDE2DAY)
  • Turkish (Translated by MustafaKemalAtaturk)
  • Bosnian (Translated by Tagic)

Installation

Overall, you have 3 options:

Downloading the latest launcher.jar file

The latest launcher.jar is available under https://github.com/Bios-Marcel/ServerBrowser/releases/latest , but it will require you to have Java 8 or later installed, i strongly suggest installing Java 9, since future versions of this project will use Java 9.

Downloading the latest Installer (NOT SUPPORTED ANYMORE)

The latest installer is also available under https://github.com/Bios-Marcel/ServerBrowser/releases/tag/8.5.7
Unlike when using the launcher.jar file, the installer won’t require you to download anything other than the installer itself.
The installer isn’t supported after version 8.5.7 anymore.

Build all the stuff yourself

In case you are paranoid and scared that i might have infected the files in the release section, feel free to build the project yourself.
For further information on how to build the project, check the Build Section below

Troubleshooting

Your client isn’t able to fetch servers

If your Client isn’t able to fetch any servers anymore, the first thing you should do, is to try and download the latest version of the client.

The second thing you might want to check, is your firewall. Make sure you haven’t blocked the application itself.

Your client doesn’t start anymore

In case your client doesn’t start anymore, the first thing you should do, is to try and download the latest version of the client.

If downloading the latest version of the client doesn’t help, try removing your currently installed Java runtime, if you have never installed a Java runtime, uninstall the ServerBrowser using the default Windows uninstalling procedure. After deleting Java and/or the ServerBrowser reinstall it.

Pictures

There is a light and a dark theme, here are screenshots including both themes:

Servers Dark

Servers Light

Past Usernames Dark

Past Usernames Light

Version Changer Dark

Version Changer Light

Files Dark

Files Light

Settings Dark

Settings Light

Documentation (Outdated)

Javadoc is available under: (https://bios-marcel.github.io/ServerBrowser-Doc/overview-summary.html)

User Documentation (not complete) is available under: (https://github.com/Bios-Marcel/ServerBrowser/wiki)

You want to help?

You can help by reporting bugs, recommending new features or creating pull requests.

Another way for you to contribute, is to help localizing the application

How to create a new language file

If you want to translate the program into another language, simply copy /client/src/main/resources/com/msc/serverbrowser/localization/Lang_en.properties and name it lang_YOUR_COUNTRIES_SHORTCUT.propeties.
After having done the translation, send me the file or do a pull request on GitHub. Please be careful to not modify any of the key names, that means only edit whats behind a =.
If possible try to escape all characters, since there is currently to UTF-8 support for language files.

To be localized

Note: Some of the following key-value pairs might already be correct, in that case i don’t know it though.

German

Done

Georgian

  1. errorFetchingServers=Couldn't fetch servers
  2. favourites=Favourites
  3. pageSize=PageSize
  4. fetchingServers=Fetching servers, please wait a moment.
  5. connectToServerUsingPassword=Connect using password
  6. enterFilterValue=Enter filter value
  7. lagcomp=lagcomp:
  8. showTimestamps=Show times if available
  9. locateGTAManually=Click here to enter your GTA path manually.
  10. lastVisit=Last visit
  11. visitWebsite=Visit website
  12. gtaNotFoundPrompt=Will be automatically detected if left empty
  13. addToFavourites=Add to favourites
  14. rememberLastView=Remember last view
  15. inputMethodText=Input method text editing and language switching
  16. ba=Bosnian
  17. sureYouWantToRestoreLegacySettingsAswell=Do you also, in addition to the application settings, want to reset the SA-MP settings?
  18. cantFindGTA=Can't find GTA installation
  19. sureYouWantToRestoreLegacySettings=Are you sure, that you want to reset the SA-MP settings?
  20. customSampPath=Custom SA-MP Path
  21. noFavouriteServers=You don't have any favourites.
  22. directmode=Directmode (Fix chat text drawing problems)
  23. usePreReleases=Use pre-releases
  24. tr=Turkish
  25. activePlayers=Active players: {0}
  26. showChatlogColors=Show colors
  27. showChatlogColorsAsText=Show colors as text
  28. copyIpAddressAndPort=Copy IP address and port
  29. donate=Donate
  30. applyUsername=Apply username
  31. all=All
  32. removeUsernameSingular=Remove username
  33. downloadingUpdate=Downloading update
  34. history=History
  35. restoreLegacySettingsToDefault=Restore SA-MP settings to default
  36. removeUsernamePlural=Remove usernames
  37. connectingToServer=Connecting to server
  38. allowCachingSampVersions=Allow caching downloaded SA-MP versions
  39. retrieving=Retrieving ...
  40. connectToServer=Connect to server
  41. removeFromFavourites=Remove from favourites
  42. checkingForUpdates=Checking for updates
  43. serverMightBeOfflineConnectAnyways=The server might not be online, do you want to try connecting to it anyways?
  44. noServerHistory=You haven't joined any servers recently.
  45. enterServerPasswordMessage=Enter the servers password (Leave empty if you think there is none).
  46. multicoreUsage=Multicore usage
  47. openDonationPageTooltip=Opens the 'Donate' section of the GitHub project page

Greek

  1. errorFetchingServers=Couldn't fetch servers
  2. favourites=Favourites
  3. fetchingServers=Fetching servers, please wait a moment.
  4. chatTimestamps=Chat Timestamps
  5. connectToServerUsingPassword=Connect using password
  6. enterFilterValue=Enter filter value
  7. lagcomp=lagcomp:
  8. showTimestamps=Show times if available
  9. locateGTAManually=Click here to enter your GTA path manually.
  10. lastVisit=Last visit
  11. visitWebsite=Visit website
  12. gtaNotFoundPrompt=Will be automatically detected if left empty
  13. addToFavourites=Add to favourites
  14. generalSettingsTitle=General
  15. sureYouWantToRestoreLegacySettingsAswell=Do you also, in addition to the application settings, want to reset the SA-MP settings?
  16. sampVersion=SA-MP Version {0}
  17. cantFindGTA=Can't find GTA installation
  18. ping=Ping:
  19. sureYouWantToRestoreLegacySettings=Are you sure, that you want to reset the SA-MP settings?
  20. noFavouriteServers=You don't have any favourites.
  21. usePreReleases=Use pre-releases
  22. informationSettingsTitle=Information
  23. showChatlogColors=Show colors
  24. showChatlogColorsAsText=Show colors as text
  25. copyIpAddressAndPort=Copy IP address and port
  26. donate=Donate
  27. applyUsername=Apply username
  28. all=All
  29. removeUsernameSingular=Remove username
  30. downloadingUpdate=Downloading update
  31. versionInfo=Version: {0}
  32. history=History
  33. chatlogs=Chatlogs
  34. restoreLegacySettingsToDefault=Restore SA-MP settings to default
  35. removeUsernamePlural=Remove usernames
  36. connectingToServer=Connecting to server
  37. retrieving=Retrieving ...
  38. connectToServer=Connect to server
  39. servers=Servers: {0}
  40. removeFromFavourites=Remove from favourites
  41. checkingForUpdates=Checking for updates
  42. serverMightBeOfflineConnectAnyways=The server might not be online, do you want to try connecting to it anyways?
  43. noServerHistory=You haven't joined any servers recently.
  44. enterServerPasswordMessage=Enter the servers password (Leave empty if you think there is none).
  45. openDonationPageTooltip=Opens the 'Donate' section of the GitHub project page

Dutch

  1. errorFetchingServers=Couldn't fetch servers
  2. favourites=Favourites
  3. fetchingServers=Fetching servers, please wait a moment.
  4. connectToServerUsingPassword=Connect using password
  5. enterFilterValue=Enter filter value
  6. lagcomp=lagcomp:
  7. showTimestamps=Show times if available
  8. locateGTAManually=Click here to enter your GTA path manually.
  9. gamemodeTableHeader=Gamemode
  10. lastVisit=Last visit
  11. visitWebsite=Visit website
  12. addToFavourites=Add to favourites
  13. ba=Bosnian
  14. sureYouWantToRestoreLegacySettingsAswell=Do you also, in addition to the application settings, want to reset the SA-MP settings?
  15. cantFindGTA=Can't find GTA installation
  16. ping=Ping:
  17. downloadSettingTitle=Downloads
  18. sureYouWantToRestoreLegacySettings=Are you sure, that you want to reset the SA-MP settings?
  19. map=Map:
  20. website=Website:
  21. noFavouriteServers=You don't have any favourites.
  22. usePreReleases=Use pre-releases
  23. tr=Turkish
  24. showChatlogColors=Show colors
  25. showChatlogColorsAsText=Show colors as text
  26. copyIpAddressAndPort=Copy IP address and port
  27. donate=Donate
  28. applyUsername=Apply username
  29. all=All
  30. removeUsernameSingular=Remove username
  31. downloadingUpdate=Downloading update
  32. history=History
  33. restoreLegacySettingsToDefault=Restore SA-MP settings to default
  34. removeUsernamePlural=Remove usernames
  35. updatesSettingTitle=Updates
  36. connectingToServer=Connecting to server
  37. retrieving=Retrieving ...
  38. connectToServer=Connect to server
  39. servers=Servers: {0}
  40. removeFromFavourites=Remove from favourites
  41. checkingForUpdates=Checking for updates
  42. serverMightBeOfflineConnectAnyways=The server might not be online, do you want to try connecting to it anyways?
  43. noServerHistory=You haven't joined any servers recently.
  44. enterServerPasswordMessage=Enter the servers password (Leave empty if you think there is none).
  45. serverOffline=Server is offline.
  46. openDonationPageTooltip=Opens the 'Donate' section of the GitHub project page

Russian

  1. errorFetchingServers=Couldn't fetch servers
  2. favourites=Favourites
  3. connectToServerUsingPassword=Connect using password
  4. enterFilterValue=Enter filter value
  5. lagcomp=lagcomp:
  6. showTimestamps=Show times if available
  7. locateGTAManually=Click here to enter your GTA path manually.
  8. lastVisit=Last visit
  9. visitWebsite=Visit website
  10. addToFavourites=Add to favourites
  11. ba=Bosnian
  12. sureYouWantToRestoreLegacySettingsAswell=Do you also, in addition to the application settings, want to reset the SA-MP settings?
  13. cantFindGTA=Can't find GTA installation
  14. ping=Ping:
  15. sureYouWantToRestoreLegacySettings=Are you sure, that you want to reset the SA-MP settings?
  16. noFavouriteServers=You don't have any favourites.
  17. usePreReleases=Use pre-releases
  18. tr=Turkish
  19. showChatlogColors=Show colors
  20. showChatlogColorsAsText=Show colors as text
  21. copyIpAddressAndPort=Copy IP address and port
  22. donate=Donate
  23. applyUsername=Apply username
  24. all=All
  25. removeUsernameSingular=Remove username
  26. downloadingUpdate=Downloading update
  27. history=History
  28. restoreLegacySettingsToDefault=Restore SA-MP settings to default
  29. removeUsernamePlural=Remove usernames
  30. connectingToServer=Connecting to server
  31. retrieving=Retrieving ...
  32. connectToServer=Connect to server
  33. removeFromFavourites=Remove from favourites
  34. checkingForUpdates=Checking for updates
  35. serverMightBeOfflineConnectAnyways=The server might not be online, do you want to try connecting to it anyways?
  36. noServerHistory=You haven't joined any servers recently.
  37. enterServerPasswordMessage=Enter the servers password (Leave empty if you think there is none).
  38. openDonationPageTooltip=Opens the 'Donate' section of the GitHub project page

Polish

Done

Romanian

  1. connectToServerUsingPassword=Connect using password
  2. lagcomp=lagcomp:
  3. lastVisit=Last visit
  4. visitWebsite=Visit website
  5. addToFavourites=Add to favourites
  6. ba=Bosnian
  7. generalSettingsTitle=General
  8. sureYouWantToRestoreLegacySettingsAswell=Do you also, in addition to the application settings, want to reset the SA-MP settings?
  9. ping=Ping:
  10. sureYouWantToRestoreLegacySettings=Are you sure, that you want to reset the SA-MP settings?
  11. usePreReleases=Use pre-releases
  12. showChatlogColorsAsText=Show colors as text
  13. copyIpAddressAndPort=Copy IP address and port
  14. restoreLegacySettingsToDefault=Restore SA-MP settings to default
  15. connectToServer=Connect to server
  16. removeFromFavourites=Remove from favourites
  17. enterServerPasswordMessage=Enter the servers password (Leave empty if you think there is none).

Spanish

  1. favourites=Favourites
  2. connectToServerUsingPassword=Connect using password
  3. enterFilterValue=Enter filter value
  4. showTimestamps=Show times if available
  5. lastVisit=Last visit
  6. visitWebsite=Visit website
  7. addToFavourites=Add to favourites
  8. ba=Bosnian
  9. generalSettingsTitle=General
  10. sureYouWantToRestoreLegacySettingsAswell=Do you also, in addition to the application settings, want to reset the SA-MP settings?
  11. sureYouWantToRestoreLegacySettings=Are you sure, that you want to reset the SA-MP settings?
  12. noFavouriteServers=You don't have any favourites.
  13. usePreReleases=Use pre-releases
  14. tr=Turkish
  15. showChatlogColors=Show colors
  16. showChatlogColorsAsText=Show colors as text
  17. copyIpAddressAndPort=Copy IP address and port
  18. donate=Donate
  19. applyUsername=Apply username
  20. all=All
  21. removeUsernameSingular=Remove username
  22. downloadingUpdate=Downloading update
  23. history=History
  24. restoreLegacySettingsToDefault=Restore SA-MP settings to default
  25. removeUsernamePlural=Remove usernames
  26. no=No
  27. connectingToServer=Connecting to server
  28. connectToServer=Connect to server
  29. removeFromFavourites=Remove from favourites
  30. checkingForUpdates=Checking for updates
  31. serverMightBeOfflineConnectAnyways=The server might not be online, do you want to try connecting to it anyways?
  32. noServerHistory=You haven't joined any servers recently.
  33. enterServerPasswordMessage=Enter the servers password (Leave empty if you think there is none).

Turkish

  1. favourites=Favourites
  2. pageSize=PageSize
  3. connectToServerUsingPassword=Connect using password
  4. enterFilterValue=Enter filter value
  5. showTimestamps=Show times if available
  6. gamemodeTableHeader=Gamemode
  7. lastVisit=Last visit
  8. visitWebsite=Visit website
  9. addToFavourites=Add to favourites
  10. sureYouWantToRestoreLegacySettingsAswell=Do you also, in addition to the application settings, want to reset the SA-MP settings?
  11. ping=Ping:
  12. sureYouWantToRestoreLegacySettings=Are you sure, that you want to reset the SA-MP settings?
  13. fpsLimit=FPS Limit
  14. website=Website:
  15. usePreReleases=Use pre-releases
  16. showChatlogColors=Show colors
  17. showChatlogColorsAsText=Show colors as text
  18. copyIpAddressAndPort=Copy IP address and port
  19. donate=Donate
  20. applyUsername=Apply username
  21. all=All
  22. removeUsernameSingular=Remove username
  23. downloadingUpdate=Downloading update
  24. history=History
  25. restoreLegacySettingsToDefault=Restore SA-MP settings to default
  26. removeUsernamePlural=Remove usernames
  27. retrieving=Retrieving ...
  28. connectToServer=Connect to server
  29. removeFromFavourites=Remove from favourites
  30. checkingForUpdates=Checking for updates
  31. enterServerPasswordMessage=Enter the servers password (Leave empty if you think there is none).

Bosnian

  1. pageSize=PageSize
  2. connectToServerUsingPassword=Connect using password
  3. lagcomp=lagcomp:
  4. gamemodeTableHeader=Gamemode
  5. ping=Ping:
  6. fpsLimit=FPS Limit
  7. usePreReleases=Use pre-releases
  8. enterServerPasswordMessage=Enter the servers password (Leave empty if you think there is none).

Build

This project is managed using gradle.

Building with Gradle

To see which tasks are available, run:

on Unix:

  1. $ ./gradlew tasks

on Windows:

  1. $ ./gradlew.bat tasks

The first time you execute gradlew (gradle wrapper) it will download a local copy of gradle into the project folder .gradle. This will not be committed to version control.

You are of course free to use your own or systems copy of gradle, but this approach has the advantage that we all share the same version of gradle.

Running tasks on subprojects

To run tasks on the subprojects, you can either cd into the subproject and run the task, e.g.:

  1. $ cd client
  2. $ ../gradlew run

Assemble and test the build outputs. You will find the results in the build folder of client.

  1. $ ./gradlew build

In order to build a runnable .jar file, run:

  1. $ ./gradlew shadowJar

Syncing gradle with Eclipse

Typically, when you import a gradle project into eclipse, it takes care of creating the eclipse project files via the plugin buildship.

However, if you want to be extra sure, don´t want to use the plugin or need to fix some synchronization issue between eclipse and gradle; It is useful to know how to manually do it:

From the parent project run:

  1. $ ./gradlew eclipseClean eclipse

Eclipse will instantly reload the fresh project settings files.

You need help?

Send me an E-Mail