Developers

Here you can find source code, a description of the Unreal Software Web API and more!

Downloads

Source Codes

Others

Unreal Software Connect

A web API which allows external services and websites to detect if a user is the owner of a certain UnrealSoftware.de account.

Usage

Step 1: Get the nick

Let the user enter their UnrealSoftware.de username
Step 2: Open Link

Let the user open the following link
https://unrealsoftware.de/connect.php?setkey=RANDOM
RANDOM should be a random value (String) that you can define yourself. Maximum length is 255 characters. Random numbers or timestamps are advisable. The user has to be logged in at UnrealSoftware.de to open that link. The connect value of the user account will then be set to the given value. (with the optional parameter autoclose=1 the window will be closed after confirmation, with the optional parameter redirect=URL you will be redirected after confirmation)
Step 3: Check membership

Afterwards open the following link internally
https://unrealsoftware.de/connect.php?keyof=USERNAME&iskey=RANDOM
USERNAME is the name which has been entered in step 1. RANDOM has to be the same value as in step 2.

The script returns the user ID (a number > 0) if the account has the connect value RANDOM. This means, that the account belongs to this user. Otherwise it returns 0.

You can also use keyofid=USERID instead of keyof=USERNAME if you want to work with the ID instead.

Please note

Step 3 resets the connect value. So step 3 can only return the ID once. Moreover usernames may contain special characters. You should use the function urlencode() when using PHP or a comparable function in other languages!

Moreover you can use the script to get the name or ID of a user:

Get name by ID

https://unrealsoftware.de/connect.php?getname=USERID

Get ID by name

https://unrealsoftware.de/connect.php?getid=USERNAME

User List

A list with all users in a pure text format is available at

https://unrealsoftware.de/users.php?raw&s=STARTOFFSET&c=COUNT

with STARTOFFSET as offset value (start at user X with 0 for the first) and the amount COUNT.

Returns one line per user with the structure: ID,NAME. Replace raw with rawc to get a list including the country codes: ID,NAME,COUNTRY.

You can use

https://unrealsoftware.de/usercount.php

to get the total number of registered users and

https://unrealsoftware.de/usercount.php?highest

to get the highest used ID.

User Data

You can request user data using

https://unrealsoftware.de/getuserdata.php?id=ID&data=DATA

For ID insert an Unreal Software / U.S.G.N. user ID. For DATA you have to use one of the following values:

avatar rel. path of the user avatar image (prepend https://unrealsoftware.de/ for complete URL). No output if there is no avatar.
name name of the user.
mode mode of the user as internal integer ID.
modetxt mode of the user as string.
country country of the user (country code with 2 letters or -- if not set).
regdate registration date as unix timestamp. 0 if user registered before November 2004.
json Returns all of the above values (except for modetxt) plus user ID as JSON.