ServUO Client API (Replacement for art API)

dmurphy

Admin
ServUO Developer
Feb 10, 2014
1,005
225
30
Today I have finished my rewrite of the Art API from PHP to c# and asp.

The API no longer serves just art but will serve most client information a user requires. As time goes on more information will be added to the endpoint.

Right now what is available:
  • Item art
  • Gump art
  • Multi art
  • Animations (new)
  • Sounds(new)
I will continue to add to this list as time goes on.

Not only that but the API is open source now under the GNU v3 license and anyone is free to submit bug fixes and features or use it for their own needs.

Endpoints are available at: http://services.servuo.com/API
Source at: https://github.com/ServUO/Client-API
Have fun!
 

dmurphy

Admin
ServUO Developer
Feb 10, 2014
1,005
225
30
It is a web based project. You can pull client files such as item images or animations and include them dynamically in your own projects. The most appropriate use of this would be to include images on your own website. I will come up with some example code that should help explain it soon.
 

dmurphy

Admin
ServUO Developer
Feb 10, 2014
1,005
225
30
and we can use this code on our web pages from ServUO directly? Not our servers?
The source code is available if you want to host the API yourself on your own server, however it is an ASP based project so would require a windows host (Untested on mono)

Here is a quick simple example an animation of the human bodyvalue walking while hued purple

aServices_ServUO_com_uoapi_anim_400_35_.gif
 

john burns

Well-Known Member
Mar 12, 2014
715
20
48
Michigan, USA
vachiadroylia.dynu.net
Shard Name
Vachia Droylia
Ok, I see.

Install into our own server, then have our webpages do an image link to the api requesting a certain picture, then if we decide to, we hue it what color we want.

Sounds simple until you try using it. LOL.

* * * * E D I T * * * *
On a side note, with this package, it will save on space when you decide to host your webpage.
 
Last edited:

dmurphy

Admin
ServUO Developer
Feb 10, 2014
1,005
225
30
Ok, I see.

Install into our own server, then have our webpages do an image link to the api requesting a certain picture, then if we decide to, we hue it what color we want.

Sounds simple until you try using it. LOL.
Yep pretty much, but you do not need to install it on your own server. I only request that from people who will pull thousands of requests per day. For 99% of users the ServUO hosted version will do just fine.
 

john burns

Well-Known Member
Mar 12, 2014
715
20
48
Michigan, USA
vachiadroylia.dynu.net
Shard Name
Vachia Droylia
I would prefer to install it myself. Just for the custom stuff. And for general purpose.
Nothing against you.
Its me.
And I am sure alot of people will feel this way too. But thanks for giving us options.
 

dmurphy

Admin
ServUO Developer
Feb 10, 2014
1,005
225
30
I would prefer to install it myself. Just for the custom stuff. And for general purpose.
Nothing against you.
Its me.
And I am sure alot of people will feel this way too. But thanks for giving us options.
No problem. People with custom files were one of the main reasons I decided to open source it. If you decide to use it let me know. I would love to see projects that implement it.
 

dmurphy

Admin
ServUO Developer
Feb 10, 2014
1,005
225
30
Update

Changes:
  • New feature: Paperdoll builder. See below for information
  • Bugfix: Fix for item art hues being one off.

Paperdoll builder:

This is a neat feature that allows you to pass in gear for the system to build a paperdoll image.

This is what the endpoint expects: <BodyHue>:<Isfemale>,<ItemID>:<Hue>,<ItemID>:<Hue>,<ItemID>:<Hue>,<ItemID>:<Hue>,......

An example of this is:
Code:
http://services.servuo.com/uoapi/paperdoll?gear=1003:false,50434:849,50543:0,50480:1711,50544:0,50542:0,50546:0,50545:0,50984:0,50560:0,
Which will result in aservices_servuo_com_uoapi_paperdoll_47221d3642a1d849a201139b7e5e9472._.png
 
Last edited:
  • Like
Reactions: Vorspire
X

xG00BERx

This is some cool stuff. I see some potentially awesome things coming from this! Keep it up everyone! Especially Dmurph!
 
  • Like
Reactions: dmurphy

dmurphy

Admin
ServUO Developer
Feb 10, 2014
1,005
225
30
New feature: Avatar generation from paperdoll.

Just a simple extension of the previous paperdoll update. Apped ?avatar=true to your uri for it to happen.

N.B. because UO art files are all so low resolution the avatars generated are not so pretty.

Example useage:
Code:
http://services.servuo.com/uoapi/paperdoll?gear=1003:false,50434:849,50543:0,50480:1711,50544:0,50542:0,50546:0,50545:0,50984:0,50560:0&avatar=true
Output: aservices_servuo_com_uoapi_paperdoll_bfdca955988545f7cefc1076ede603e3._.png
 

BrianFreud

Member
Feb 26, 2016
6
0
41
Very cool - I was wishing for a way to generate some hued hair pics just the other day. :D

For item images, I wonder is there a way to generate stacked images? So 1 gp, 3 gp, 6 gp, 2 bandages, etc? I'm pretty sure gold all is the same itemtype, though I've not looked yet to see if there's a different internal image number for stacks.
 

BrianFreud

Member
Feb 26, 2016
6
0
41
Ok lol, gold was a bad example (though interesting that EUO maps all three to the same itemtype). Most stacks, though, I don't think have separate images for stacks - reagents, bandages, grass, snow, etc. Seems to be a standard offset, then the same graphic layered over top of the first instance of the graphic.

@dmurphy, a suggestion for the mob API; rather than animated or static, a third option, where the static image from each angle cycles, for showing off what the mob looks like. Basically what you'd get by turning these into a gif, possibly with a flag to set whether you're cycling 0>7, or 7>0, to control which direction the mob appears to spin in:

aservices_servuo_com_uoapi_anim_987_0_0_true_.gifhttp://services.servuo.com/uoapi/anim/987/0/0/true
aservices_servuo_com_uoapi_anim_987_0_1_true_.gifhttp://services.servuo.com/uoapi/anim/987/0/1/true
aservices_servuo_com_uoapi_anim_987_0_2_true_.gifhttp://services.servuo.com/uoapi/anim/987/0/2/true
aservices_servuo_com_uoapi_anim_987_0_3_true_.gifhttp://services.servuo.com/uoapi/anim/987/0/3/true
aservices_servuo_com_uoapi_anim_987_0_4_true_.gifhttp://services.servuo.com/uoapi/anim/987/0/4/true
aservices_servuo_com_uoapi_anim_987_0_5_true_.gifhttp://services.servuo.com/uoapi/anim/987/0/5/true
aservices_servuo_com_uoapi_anim_987_0_6_true_.gifhttp://services.servuo.com/uoapi/anim/987/0/6/true
aservices_servuo_com_uoapi_anim_987_0_7_true_.gifhttp://services.servuo.com/uoapi/anim/987/0/7/true