entity interface changed, examples updated, Readme updated